Historic,  Archive  Document 

Do  not  assume  content  reflects  current 
scientific  knowledge,  policies,  or  practices. 


ted  States 
//  v/^  A  .'LI     Dartment  of 

Forest  Service 

Intermountain 
Forest  and  Range 
Experiment  Station 

General  Technical 
Report  INT-105 

May  1981 


User's  Manual 
RID^POLY 
Geographic 
Information  ^ 
System  I 


Wallace  A.  Deschene 


o 
o 

CO 


The  use  of  trade,  firm,  or  corporation  names  in  this  pubhcation 
is  for  the  information  and  convenience  of  the  reader.  Such  use 
does  not  constitute  an  official  endorsement  or  approval  by  the 
U.S.  Department  of  Agriculture  of  any  product  or  service  to 
the  exclusion  of  others  which  mav  be  suitable. 


United  States 
Department  of 
Agriculture 

Forest  Sen/ice 

Intermountain 
Forest  and  Range 
Experiment  Station 

General  Technical 
Report  INT-105 

May  1981 


User's  Manual 
RID*  POLY 
Geographic 
Information 
System 


Wallace  A.  Deschene 


THE  AUTHOR 


WALLACE  A.DESCHENE  is  a  computer  systems 
analyst  with  the  Intermountain  Station  Computer 
Science  Section  in  Missoula,  Mont.  He  earned  a 
bachelor's  degree  in  computer  science  at  Moorehead 
State  University  (1974),  a  bachelor's  degree  in  geog- 
graphy  at  Moorehead  State  University  (1974),  and  a 
master's  degree  in  geography  at  the  University  of  Idaho 
(1977). 


ACKNOWLEDGMENTS 

The  original  version  of  RID*  POLY,  formerly  known  as 
the  Wildland  Resource  Information  System  (WRIS),  was 
designed  to  operate  on  a  UNIVAC  1 108  computer  by 
staff  of  the  Pacific  Southwest  Forest  and  Range  Experi- 
ment Station,  USDA  Forest  Service,  Berkeley,  Calif.  The 
code  was  translated  to  operate  on  IBM  360/370  com- 
puters by  Wallace  A.  Deschene  and  Roger  McCluskey  at 
the  Intermountain  Forest  and  Range  Experiment  Sta- 
tion's Forestry  Sciences  Laboratory  in  Moscow,  Idaho. 
RID*POLY  is  currently  running  on  an  AMDAHL470  V6 
computer,  with  the  IBM  VS2  MVS  Operating  System. 
Robert  Russell,  David  Sharpnack,  Joyce  Dye,  Dave 
Blakeman,  Elliot  Amidon,  and  Mike  Travis  of  Pacific 
Southwest  Station  provided  generous  assistance  in  the 
translation  tasks.  David  Erickson  and  Dan  Beus  of  Inter- 
mountain Station  in  Moscow,  Idaho,  provided 
assistance  in  producing  the  most  recent  version  of  the 
manual  and  source  code. 

Sections  of  this  manual  have  been  reproduced  from  the 
UNIVAC  1 108  "Wildland  Resource  Information  System: 
User's  Guide"  by  Russell,  Sharpnack,  and  Amidon.' 
More  information  on  the  development  and  character- 
istics of  WRIS  can  be  obtained  from  "WRIS:  A 
Resource  Information  System  for  Wildland  Manage- 
ment" by  Russell,  Sharpnack,  and  Amidon.^ 


'Russell,  Robert  M.,  David  A.  Sharpnack,  and  Elliot  L.  Amidon.  1975. 
Wildland  Resource  Information  System:  user's  guide.  USDA  For.  Serv. 
Gen.  Tech.  Rep.  PSW-10, 36  p.  Pac.  Southwest  For.  and  Range  Exp.  Stn., 
Berkeley,  Calif. 

'Russell,  Robert  M.,  David  A.  Sharpnack,  and  Elliot  L.  Amidon.  1975. 
WRIS:  a  resource  information  system  for  wildland  management.  USDA 
For.  Serv.  Gen.  Tech.  Rep.  PSW-107, 12  p.  Pac.  Southwest  For.  and 
Range  Exp.  Stn.,  Berkeley,  Calif. 


CONTENTS 


Page 

0  FOREWORD    0.1 

1  DEFINITIONS    1.1 

2  PROGRAM  NOTES    2.1 

2.1  FUes   2.1 

2.2  Special  Characters   2.1 

■  2.3  Card  Formats   2.1 

2.3.1  System  Cards    2.1 

2.3.2  RID*POLY  Control  Sections   2.4 

2.3.2.1  FILES    2.4 

2.3.2.2  HEADER    2.4 

2.3.2.3  HEADER  UPDATES   2.5 

2.3.2.4  OPTIONS   2.5 

2.3.2.5  CORRECTIONS    2.5 

2.3.2.6  LABELS    2.5 

2.3.2.7  PLOT  OPTIONS    2.5 

2.3.2.8  MOSAIC  OPTIONS    2.5 

2.3.2.9  POLYGON  SELECTIONS   2.6 

2.3.2.10  ENDS   2.7 

2.4  Integer  Lists   2.7 

2.5  Comments    2.7 

2.6  Printout   2.8 

2.7  Limitations   2.8 

3  PREPARING  MAPS    3.1 

3.1  Automatic  Scanning   3.1 

3.2  Manual  Digitizing   3.1 

4  PROCESSING  INPUT  DATA   4.1 

4. 1  Processing  Density  Data  (FREQTB)   4.1 

4.2  Processing  Binary  Data  (BIPRIN)   4.2 

4.3  Processing  Digitizer  Data  (HANDY)   4.3 

4.4  Editing  a  Binary  Map   4.4 

4.4.1  Editing  Guidelines    4.4 

4.4.2  Recording  Error  Corrections   4.8 

5  PRODUCING  A  POLYGON  MAP-FILE   5.1 

5.1  Control  Points    5.1 

5.2  Recording  Polygon  Labels   5.1 

5.2.1  Setup    5.1 

5.2.2  Label  Recording   5.1 

5.3  Extracting  Polygons  from  Binary  Map-File  (POLLY)   5.2 

5.4  Editing  POLLY  Printout   5.4 

6  PLOTTING  A  MAP  (CHART)   6.1 

7  OVERLAYING  MAPS  (MOSAIC)   7.1 

8  COMBINING  POLYGON  MAP-FILES  (MERGE)   8.1 

9  MISCELLANEOUS  MAP-FILE  CORRECTIONS  (TONIC)   9.1 

10  UNIVERSAL  DATA  EXCHANGE  FORMAT  (XCHG)   10. 1 

11  RID*POLY  TO  RID*GRID  CONVERSION  (PGRID)   11.1 


APPENDIXES 

Page 

APPENDIX  A         RID*POLY  PROCEDURE    A.l 

APPENDIX  B  DATA  FORMATS   B.l 

B.O  Manual  Digitizer  Input  to  WRIS   B.l 

B.l  Scanner  Data  Formats   B.l 

B.1.1  SCANDIG  Binary  Output   B.l 

B.l. 2  PASEDENA  PDS  lOlOA  Density  Format   B.2 

B.2  Binary  Map-File  Format  (MODE  1)   B.2 

B.3  Polygon  Map-File  Format  (MODE  2)   B.3 

B.3.1  Label  Record  Format   B.3 

B.3. 2  Polygon  Record  Format   B.3 

B.4  Universal  Data  Exchange  Format   B.4 

B.5  RID*GRID  Magnetic  Tape  Formats   B.6 

B.5.1  D,E,  and  F  Tape  Format   B.6 

B.5. 2  Label  Tape  Format   B.6 

APPENDIX  C         METRIC  CONVERSION    C.l 

APPENDIX  D         DISTRIBUTION  NOTES  FOR  THE  IBM  VERSION  OF  RID*POLY   D.l 

APPENDIX  E  RID*POLY  RUNSTREAM  GENERATOR   E.l 

APPENDIX  F  RID*POLY  SAMPLE  RUNS   F.l 

F.l  BIPRIN   F.2 

F.2  CHART   F.9 

F.3  HANDY    F.13 

F.4  MERGE    F.22 

F.5  MOSAIC   F.27 

F.6  PGRID   F.35 

F.7  POLLY    F.45 

F.8  TONIC    F.55 

F.9  XCHG   F.58 

TABLES 

Page 

Table  0.1    Data  Recording  Devices  and  Processing  Procedures   0.2 

Table  2.1    RID* POLY  Memory  Requirements   2.3 

Tabled  Source  Code  Changes  Required  for  Metric  Conversion   C.2 

Table  D.  1  Distribution  Tape  Contents   D.4 

FLOWCHARTS 

Flowchart  0. 1  Processing  required  to  produce  a  polygon  map-file   0.3 

Flowchart  0.2  Plotting  a  polygon  map- file  (CHART)   0. 4 

Flowchart  0.3  Overlaying  polygon  map-files  (MOSAIC)   0.4 

Flowchart  0.4  Combining  polygon  map-files  (MERGE)   0.5 

Flowchart  0.5  Updating  a  polygon  map-file  (TONIC)   0.5 

Flowchart  0.6  Producing  data  in  the  Universal  Exchange  Format  (XCHG)   0.6 

Flowchart  0. 7  Converting  RID*POLY  data  to  RID*GRID  data  (PGRID)   0.6 

FIGURES 

Figure  3.1  Polygon  islands   3.2 

Figure  3.2  Islands  connected   3.2 

Figure  4.1  Example  of  lines  needing  ADDS   4.6 

Figure  4.2  Example  of  lines  needing  DELETES   4.7 

Figure  5. 1  Results  of  thinning  the  examples  in  figure  4. 1  without  making  ADDS   5.6 

Figure  5.2  Results  of  thinning  the  examples  in  figure  4.2  without  making  DELETES   5.7 

Figure  5.3  Results  of  making  ADDS  in  the  examples  in  figure  4.1   5.8 

Figure  5.4  Results  of  making  DELETES  in  the  examples  in  figure  4.2   5.9 

Figure  5.5  Results  of  thinning  the  examples  in  figure  5.3   5. 10 

Figure  5.6  Results  of  thinning  the  examples  in  figure  5.4   5.11 


0.  FOREWORD 


The  RID*POLY  program  is  the  National  Forest  System  version  of  the  Wildland  Resource  Information  System 
(WRIS)  (Russell  and  others  1975).  The  RID*POLY  program  is  the  polygonal  processor  of  the  RID  (Resources  Infor- 
mation Display)  System  that  stores  and  manipulates  data  attributed  to  geographical  areas.  The  resource  manager 
defines  an  area  by  drawing  a  boundary  around  it  on  a  map.  In  nature,  such  boundaries  are  irregular  in  shape.  Their 
shapes  are  retained  within  the  system  by  representing  them  mathematically  as  multiple-edged  polygons.  "Polygons" 
are  the  fundamental  building  blocks  of  RID*POLY.  They  can  represent  timber  stands,  management  alternatives,  soil 
types,  and  other  entities.  RID*POLY  has  been  used  primarily  for  timber  management;  therefore,  examples  and  ter- 
minology in  this  report  are  from  that  discipline.  Nevertheless,  the  system  can  be  used  for  managing  resources  other 
than  timber  and  in  fields  other  than  forestry. 

A  group  of  polygons  forms  a  "map."  The  collection  of  polygons  must  completely  cover  the  surface  area,  but  not 
overlap  each  other.  All  polygons  on  one  map  must  be  from  the  same  "layer""  representing  one  attribute,  such  as 
timber  type.  Other  layers,  which  represent  different  attributes  of  the  same  geographical  area,  may  be  constructed. 
RID*POLY  can  overlay  any  two  layers  to  deal  with  combinations  of  attributes. 

The  attribute  of  a  polygon  is  expressed  as  a  "label,"  consisting  of  1  to  36  characters.  Each  polygon  must  have  a 
label.  A  label  does  not  ha\-e  to  be  unique;  it  may  occur  many  times  on  a  map,  once  for  ever\'  polygon  containing  the 
same  attribute.  In  addition.  RID*POLY  assigns  each  polygon  a  unique  serial  number  called  an  "item  number,"'  for 
further  identification. 

RID*POLY  can  be  used  for  an  entire  National  Forest  by  digitizing  each  of  the  quadrangle  maps  needed  to  cover 
the  forest  and  by  processing  the  maps  as  separate  units.  Each  layer  is  drawn  on  a  separate  map  sheet.  The  map  sheets 
are  photographically  reduced  to  enable  the  negatives  to  fit  the  dimensions  of  a  densitometer  bed  or  drum  (maximum 
size  of  9  inches  by  9  inches  for  SCANDIG). 

The  scanning  operation  stores  the  map  on  a  magnetic  tape  file  in  either  density  or  binary  form.  Density  data  are 
processed  by  a  computer  program  (FREQTB).  which  prints  a  grid  (binary  map)  that  can  be  checked  for  error.  The 
binar\'  map  consists  of  blanks  and  ones:  blanks  for  the  area  between  lines  or  background,  and  ones  for  the  points  fall- 
ing on  polygon  boundar\'  lines.  Binar)'  data  are  processed  by  a  computer  program  (BIPRIN),  which  produces  a  binary 
map  and  performs  various  editing  procedures. 

If  a  map  is  extremely  simple — few  boundan,'  lines  and  most  of  the  scanned  points  blank — it  is  more  efficient  to 
hand  digitize  and  process  it  through  the  HANDY  program  than  use  FREQTB  or  BIPRIN. 

The  POLLY  program  converts  a  binary  map  into  a  file  of  polygons,  (called  a  polygon  map  file)  and  attaches  a 
label  to  each.  A  complete  data  base  is  formed  when  the  abo\-e  process  is  performed  for  all  maps  required  to  cover  a 
designated  area. 
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Table  0.1. — Data  recording  devices  and  processing  procedures 


Data  recording 

device  Output  mode  Program  processing  sequence 


SCANDIG  Scanner 

BINARY 

BIPRIN 

POLLY 

OR 

DENSITY 

FREQTB 

BIPRIN 

POLLY 

PDS-1010  Scanner 

DENSITY 

FREQTB 

BIPRIN 

POLLY 

PDS-1010A  Scanner 

DENSITY 

FREQTB 

BIPRIN 

POLLY 

NUMONICS 

X-Y  COORDINATES 

HANDY 

BIPRIN 

POLLY 

1224  Digitizer 


The  following  sequence  of  steps  describes  the  workflow  required  to  process  maps  using  the  RID* POLY  system 
(flow  charts  0.1-0.7). 

1.  Record  the  labels  (see  section  5.2).  Recording  labels  before  any  other  work  is  done  provides  an  additional 
close  look  at  the  maps  and  may  uncover  some  remaining  logical  errors. 

2.  Produce  and  scan  negative  or  digitize  source  map. 

3.  Convert  input  into  a  binary  map-file,  with  BIPRIN  for  binary  data  (see  section  4.2),  FREQTB  for  density 
data  (see  section  4.1),  or  HANDY  for  digitizer  data  (see  section  4.3). 

4.  Edit  the  binary  map  (see  section  4.4).  If  the  binary  map  requires  many  corrections,  BIPRIN  should  be  used 
to  produce  a  permanent  map  containing  the  necessary  corrections.  Corrections  made  in  a  POLLY  run  are  not  re- 
corded permanently  and  become  expensive  to  process  if  POLLY  is  executed  more  than  once  per  map. 

5.  Extract  polygons  from  the  binary  map-file  and  produce  a  polygon  map  file  with  POLLY  (see  section  5.3). 
POLLY  output  should  be  edited  and  POLLY  rerun  until  all  error  messages  are  eliminated  (see  section  5.4). 

6.  Once  POLLY  has  been  run  without  producing  error  messages,  the  polygon  map-file  can  be  processed  by  the 
following  RID* POLY  support  programs: 

a.  Plotter  map  can  be  produced  with  CHART  (see  section  6,  flow  chart  0.2).  The  plotted  map  can  be  used  as 
an  aid  in  editing  polygon  map-files  or  as  a  means  of  producing  a  final  map  product. 

b.  Two  map  layers  can  be  overlayed  using  the  MOSAIC  routine  (see  section  7,  flow  chart  0.3). 

c.  Two  polygon  map-files  can  be  combined  using  the  MERGE  routine  (see  section  8,  flow  chart  0.4). 

d.  A  polygon  map-file  can  be  updated  using  the  TONIC  routine  (see  section  9,  flow  chart  0.5). 

e.  A  polygon  map-file  can  be  converted  into  the  Universal  Data  Exchange  Format  using  the  XCHG  routine 
(see  section  10,  flow  chart  0.6). 

f.  A  p)olygon  map-file  can  be  converted  into  a  POLY*GRID  file  using  PGRID  (see  section  11,  flow  chart  0.7). 
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Flowchart  0.1. — Processing  required  to  produce  a  polygon  map-file. 
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Flowchart  0.2. — Plotting  a  polygon  map-file  (CHART). 
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Flowchart  0.3. — Overlaying  polygon  map-files  (MOSAIC). 


Flowchart  0.4. — Combining  polygon  map-files  (MERGE). 


Flowchart  0.5. —Updating  a  polygon  map-file  (TONIC).  ||| 


0.5 


Flowchart  0.6. —Producing  data  in  ttie  Universal  Exchange  Format  (XCHG). 


Flowchart  0.7. —Converting  RID*  POLY  data  to  RID*  GRID  data  (PGRID). 


1.  DEFINITIONS 


BINARY  MAP    A  map  consisting  of  ones  ("  1" ")  and  blanks  ("  "),  ones  representing  polygon  boundaries  and  blanks 

representing  background,  produced  on  a  line  printer. 
BINARY  MAP-FILE    A  binary-  map  stored  on  a  magnetic  tape. 

BIPRIN    A  RID*POLY  program  used  to  convert  a  binar\-  or  density  file  into  a  binar\'  map-file.  This  program 

is  used  also  to  correct  a  binary-  map  and  produce  an  updated  binary  map-file. 
CHART    A  RID*POLY  program  which  plots  a  polygon  map-file. 

CONTROL  CARD    Eighty-column  card  images  that  contain  control  sections  and  entities.  These  cards  instruct  the 

RID*POLY  programs  to  perform  a  specific  task. 
CONTROL  POINTS    Reference  points  used  to  orient  the  map  sheet  and  the  binar\-  map  to  absolute  geographical 

location. 

CONTROL  SECTION    The  syntax  of  RID*POLY  consists  of  free-format  entities  in  the  form  "keyword  =  list". 

Each  entity  has  a  predefined  function.  Entities  that  are  logically  related  are  combined  into  categories  called  control 

sections.  Each  control  section  consists  of  an  identifier  followed  by  a  colon,  for  example,  FILES:,  HEADER:, 

OPTIONS;,  etc.  The  control  sections  are  described  in  section  2.3.2. 
ENVELOPE    A  set  of  four  points  (minimum  and  maximum  .x  and  y)  that  delineates  a  rectangle  encompassing  a 

polygon  (usually  the  perimeter  polygon). 
ENTITY    The  basic  form  of  the  RID*POLY  syntax  is  "key-word  =  list"  called  an  entity. 
HANDY    A  RID*POLY  program  used  to  convert  digitized  data  into  a  binary  map-file. 
HEADER    A  collection  of  keyword  information  that  identifies  a  map-file. 

ISLAND    A  polygon  that  is  not  attached  to  another  polygon  or  the  map  perimeter  in  at  least  two  places. 

ITEM    During  the  polygon  extraction  process  (POLLY)  a  sequential  number,  beginning  with  1,  is  assigned  to  each 

polygon.  This  number  is  called  an  ITEM  number  and  is  used  to  identify  the  polygon:  ITEM  10. 
KEYWORD    A  set  of  characters  that  the  RID* POLY  program  recognizes  as  a  signal  to  in\  oke  a  specific  action. 
LABEL    A  character  string,  containing  1  to  36  characters,  that  identifies  the  characteristics  of  a  polygon. 
LABEL  COMPONENT    A  subset  of  a  label  that  identifies  a  specific  characteristic  of  a  polvgon.  A  label  component 

is  delineatedby  an  "&",  for  example,  STATE  LAND&620&RANGE. 
LAYER    A  characteristic  or  quality  of  a  geographical  area  that  is  represented  in  cartographic  form. 
MAP    A  drawing  of  a  characteristic  or  quality  of  a  geographical  area  on  a  flat  surface. 

MAP-FILE    A  unit  of  information,  stored  on  a  magnetic  tape,  that  describes  (in  a  format  recognizable  by  RID*POLY) 

an  attribute  of  a  geographical  area:  quadrangle,  township,  county,  state,  etc. 
MASK    A  method  of  coding  labels  for  selection  purposes  such  that  part  of  a  label,  part  of  a  label  component,  or  an 

entire  label  component  can  be  made  transparent. 
MERGE    A  RID*POLY  program  that  combines  two  polygon  map-files. 
MOSAIC    A  RID*POLY  program  used  to  overlay  two  polygon  map-files. 

OVERLAY  PROCESS    The  procedure  in  which  the  intersections  of  two  polygons  are  assembled  into  polygons. 

PERIMETER    A  polygon  that  encompasses  all  polygons  within  a  map. 

PGRID    A  RID*POLY  program  that  converts  a  polygon  map-file  into  a  RID*GRID  file. 

POLLY    A  RID*POLY  program  that  extracts  polygons  from  a  binary  map-file  and  produces  a  polygon  map-file. 
POLYGON    A  multi-sided  figure  that  delineates  an  area  containing  homogeneous  characteristics. 
POLYGON  MAP-FILE    A  polygon  or  group  of  polygons  with  identification  stored  on  a  magnetic  tape. 
POLYGON  PERIMETER    The  x  and  y  coordinate  pairs  that  delineate  a  polygon. 

SLIVER    A  polygon  of  insignificant  size  (area  perimeter  ratio  less  than  a  specified  value)  produced  during  the  overlay 

process  by  polygon  boundaries  that  almost  coincide. 
TONIC    A  RID*POLY  program  used  to  change,  correct,  or  update  a  map-file. 
WINDOW    A  rectangular  subset  of  a  map. 

XCHG    A  RID*POLY  program  used  to  convert  a  polygon  map-file  into  a  format  (Universal  Data  Exchange  Format) 
that  can  be  used  by  other  information  systems. 
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2.  PROGRAM  NOTES 


2.1  Files 

Data  processed  by  the  RID* POLY  programs  are  stored  as  map-files  on  magnetic  tapes.  A  map-file  is  a  unit  of  in- 
formation pertaining  to  one  map.  The  tape  on  which  a  map-file  is  read  or  written  has  a  name,  referred  to  as  the 
volume  serial  number.  Each  program  requires  this  name  to  be  entered  on  the  RID*POLY  control  cards.  For  example, 
if  the  input  map-file  is  on  tape  CC3930,  the  following  card  is  necessary: 

FILES:  INPUT  =  CC3930$ 

The  same  convention  should  be  followed  for  specifying  an  output  map-file.  Occasionally  an  output  map-file  is  not 
required.  In  this  case  the  OUTPUT  file  parameter  should  be  recorded  as  OUTPUT  =  NONE;  on  the  RID*POLY  con- 
trol cards. 

Each  map-file  has  a  MODE  attribute  appearing  in  the  header  record  automatically  generated  by  the  RID* POLY 
programs.  The  MODE  identifies  the  type  of  data  a  map-FILE  CONTAINS  (see  section  2.3.2.2). 

2.2  Special  Characters 

Certain  characters  are  used  as  delimiters  in  the  RID* POLY  syntax  and  should  not  be  used  in  any  other  context. 
The  special  characters  and  their  meanings  are  as  follows: 

'  A  quote  mark  signals  the  beginning  or  end  of  a  comment — 'this  is  a  comment.' 

:  A  colon  delineates  a  control  section  (HEADER:)  or  to  indicate  a  sequence  of  numbers  (3:5). 

=  The  equal  sign  assigns  values  to  keywords  or  variables — SCALE  =  31680. 

<)  Brackets  enclose  repeating  coordinate  pairs — (15,21: 150). 

;  A  semicolon  terminates  a  keyword  phrase — FOREST  =  ST. JOE;. 

$  A  dollar  sign  signals  the  end  of  a  control  section— HEADER:  FOREST  =  ST.  JOE;SCALE  =  31680$. 

,  A  comma  separates  arguments  in  a  keyword  list — INCLUDE  ITEMS  =  1,2,3:50,51$. 

&       The  ampersand  separates  a  label  into  components  that  can  be  individually  ac- 
cessed—620&RANGE&STATE. 
(A  label  can  have  a  maximum  of  10  components.) 

#        The  number  sign  masks  components  of  a  label— INCLUDE  LABELS  =  620&#&STATE;. 

(  )      Parentheses  indicate  the  repetition  of  a  quantity — 5(4)  represents  4,4,4,4,4. 

2.3  Card  Formats 

Card  input  to  the  RID*POLY  programs  consists  of  two  types:  system  cards  and  RID*POLY  control  cards. 
2.3.1     System  Cards 

System  cards  are  dependent  on  the  computer  installation  on  which  the  RID* POLY  programs  are  being  run.  The 
rules  and  examples  presented  in  this  manual  are  designed  to  operate  RID*POLY  on  an  Amdahl  470  V6  (VS2/MVS) 
at  Washington  State  University,  Pullman  Wash. 

The  complete  set  of  system  cards  (Job  Control  Language-JCL)  required  to  execute  the  RID*POLY  programs  are 
stored  as  a  member  of  a  partitioned  data  set  (for  a  listing  see  appendix  A).  Whenever  a  RID*POLY  program  is  re- 
quested for  execution  by  an  EXEC  card,  for  example. 


II  EXEC  WRIS,PROG  =  CHART 

the  full  set  of  system  cards  is  automatically  retrieved  and  the  program  is  executed. 

The  system  cards  necessary  to  execute  a  RID*POLY  program  will  be  discussed  in  the  following  section. 

1.  Job  card.  Gives  job  information. 

//Jobname  JOB  (accnt  number,, line  limit),nanne,MSGLEVEL=:(1,1),TIME  =  time  limit 

Example: 

//CHART  JOB  (5099xxx„20),WALLY,MSGLEVEL  =  (1,1),TIME  =  2 

2.  Procedure  library.  Data  set  containing  the  system  cards  (JCL)  for  the  RID*POLY  programs.  See  appendix  A 
for  a  complete  list. 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 

3.  Program  initiation.  This  card  selects  a  RID*POLY  program  for  execution. 

//  EXEC  WRIS,PROG  =  program  name 

where  program  name  is  one  of  the  following: 
FREQTB 
BIPRIN 
HANDY 
POLLY 
CHART 
MOSAIC 
TONIC 
MERGE 
XCHG 
PGRID 

The  amount  of  memory  required  to  execute  the  RID*POLY  programs  is  given  in  table  2.1. 

4.  Input.  This  card  signals  the  beginning  of  the  RID*POLY  control  cards. 

//INPUT  DD  * 
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Table  2.1 — RID-POLY  memory  requirements 


RID* POLY  program 

Core  (*1024  bytes) 

FREQTB 

400 

BIPRIN 

400 

HANDY 

450 

POLLY 

520 

CHART 

490 

MOSAIC 

670 

TONIC 

550 

MERGE 

550 

XCHG 

420 

PGRID 

440 

2.3.2    RID*POLY  Control  Sections 

Information  that  governs  the  selection  and  processing  of  map  information  is  supphed  by  RID*POLY  control 
cards.  Control  cards  are  classified  by  section,  each  designed  to  perform  a  specific  function. 

All  RID*POLY  control  cards  are  recorded  in  a  free-field  format,  which  means  that  entities  do  not  have  to  appear 
in  specified  card  columns.  The  basic  building  blocks  of  any  control  section  are  entities  of  the  form  keyword  =  value, 
where  the  keyword  on  the  left  is  from  a  standard  list  of  keywords  and  the  value  on  the  right  can  be  a  number,  several 
numbers  separated  by  commas,  or  a  string  of  characters.  Extra  spaces  can  be  inserted  in  a  control  card  provided  they 
are  not  in  the  middle  of  a  number  or  word.  When  coding  control  cards  that  extend  beyond  column  80,  continue  in 
column  1  of  the  next  card,  as  if  it  were  one  long,  continuous  card. 

To  form  a  complete  control  section:  (1)  enter  the  name  of  the  control  section  followed  by  a  colon,  (2)  enter 
one  entity  after  another  separated  by  semicolons,  and  (3)  enter  a  dollar  sign  to  signal  an  end  of  control  section.  For 
example: 

HEADER:  FOREST  =  ST.JOE;MAP  =  33;LAYER  =  HABITATS 

The  control  sections  listed  below  pertain  to  the  entire  RID*POLY  system.  Subsequent  chapters  of  this  manual  in- 
dicate the  control  sections  needed  for  each  of  the  RID*POLY  programs. 

2.3.2.1  FILES 

The  FILES  section  is  used  to  specify  tapes  that  are  to  be  used  for  input  and  output  operations.  Possible  keywords 

are: 

INPUT  =  the  volume  serial  number  of  the  input  tape  (character). 

INPUT  ONE  =  the  volume  serial  number  of  the  first  input  tape  for  programs  that  require  two  input  map-files. 
INPUT  TWO  =  the  volume  serial  number  of  the  second  input  tape  for  programs  that  require  two  input  map- 
files. 

OUTPUT  =■  the  volume  serial  number  of  the  output  tape  (character). 

2.3.2.2  HEADER 

A  HEADER  record  is  a  collection  of  keyword  information  that  pertains  to  a  map-file.  Three  keywords  (FOREST, 
MAP,  and  LAYER)  are  used  to  identify  a  map-file  and  must  be  coded  correctly  before  an  existing  map-file  can  be  ac- 
cessed. Other  keywords  are  entered  or  generated  by  the  various  RID*POLY  programs.  Whenever  a  map-file  is  proc- 
essed, its  current  header  record  is  printed  in  full.  The  header  record  is  stored  in  the  map-file  at  all  times. 

Capital  letters  give  the  "official"  keywords,  in  the  only  spelling  recognized  by  RID*POLY  (only  one  blank  should 
be  used  between  words).  Character  strings  may  be  any  length,  but  they  should  not  be  any  longer  than  necessary. 

The  following  list  contains  all  possible  keywords  that  can  appear  in  a  HEADER  record. 

FOREST  =  The  name  of  the  forest,  (characters) 
MAP  =  Map  number,  (integer) 
LAYER  =  Layer  name,  (characters) 
LOCATION  =  Location,  (characters) 

SCALE  =  Representative  fraction  denominator,  defined  as  the  number  of  units  on  the  ground  represented  by  1 
unit  on  the  map.  For  example,  a  4-inch-per-mile  map  has  a  representative  fraction  of  1/15840  and  should  be  coded 
SCALE  =  15840;.  (integer) 

GEOGRAPHIC  CONTROL  POINTS  =  Latitude  and  longitude  of  each  control  point,  latitude  preceding 
longitude  for  each  point.  These  points  can  be  entered  in  degrees,  minutes,  and  seconds  (separated  by  colons)  or  their 
decimal  equivalents.  Do  not  omit  zeroes.  In  the  seconds  position,  you  can  record  to  the  nearest  hundredth  second 
using  a  decimal  point.  An  accuracy  of  at  least  0.5  second  is  essential.  The  maximum  meaningful  accuracy  is  0.01  sec- 
ond. For  example,  GEOGRAPHICAL  CONTROL  POINTS  =  47:45:15.05, 115:45:15.1,  47:45:15, 115:30:00.02; 

MAP  CONTROL  POINTS  =  x  and  y  coordinates  of  the  control  points,  in  units  of  0.01  inch  on  the  map  (MAP 
CONTROL  POINTS  =  100,100,100,1202,1905,1202,1905,100;).  (integers) 

GRID  CONTROL  POINTS  =  Row  and  column  coordinates  from  the  binary  map  which  correspond  to  the 
selected  MAP  CONTROL  POINTS  (GRID  CONTROL  POINTS  =  1160,7,5,120,5,1400,1160,1409;).  (integers) 
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SCAN  ROWS  =  Number  of  rows  on  binary  map.  (integer) 
SCAN  COLUMNS  =  Number  of  columns  on  binaiy  map.  (integer) 
MODE  =  n.  Identifies  the  type  of  map-file  where  n  is  an  integer  representing: 

—  1  =  scandig  density  map- file. 

0  =  scandig  binary  map-file. 

1  =  binary  map-fi'.e. 

2  =  polygon  map-file  with  a  perimeter  polygon  (POLLY). 

3  =  polygon  map-file  without  a  perimeter  polygon  (MOSAIC). 

ENVELOPE  =  Overall  envelope  of  all  polygons  on  the  map,  namely,  the  smallest  x,  smallest  y,  largest  x,  and 
largest  y.  Same  units  as  map  control  points.  These  values  are  calculated  by  the  system,  (integers) 
DATE  WRITTEN  =  The  date  the  map-file  was  written. 
TIME  WRITTEN  =  The  time  the  map-file  was  written. 
REEL  NUMBER  =  Tells  what  reel  number  the  map-file  is  on. 

POSITION  ON  REEL  =  Indicates  the  map-file  position  on  the  reel,  (integer  value) 
ZONE  =  Zone  number  of  map  in  the  State  plane  coordinate  system. 
STATE  =  Name  of  State  for  State  plane  coordinate  system. 

2.3.2.3  HEADER  UPDATES 

This  section  allows  for  modification  of  information  in  the  header  record;  existing  items  can  be  updated  or  new 
items  can  be  added.  The  keywords  described  in  the  previous  section  (2.3.2.2)  are  the  same  for  this  section. 

Example: 

HEADER  UPDATES:  MAP  =  30;  LAYER  =  HAUGAN  QUADS 

2.3.2.4  OPTIONS 

This  section  allows  certain  program  options  to  be  selected.  Refer  to  the  appropriate  chapter  (BIPRIN,  POLLY, 
CHART,  etc.)  for  specific  information. 

2.3.2.5  CORRECTIONS 

This  section  is  used  by  BIPRIN  or  POLLY  to  make  corrections  in  a  binary  map.  Items  are: 
ADDS     =  list  of  x-y  coordinate  pairs,  where  "one"  bits  are  to  be  inserted  on  a  binary  map. 
DELETES      =  List  of  x-y  coordinate  pairs  indicating  locations  on  a  binary  map  where  "one"  bits  are  to  be 
removed.  Guidelines  for  coding  corrections  are  listed  in  chapter  4. 

2.3.2.6  LABELS 

This  section  is  used  by  the  POLLY  program  to  attach  labels  to  polygons  during  the  polygon  extraction  process 
(see  chapter  5).  The  first  card  of  this  section  must  be: 

LABELS:  LIST  = 

The  list  of  labels  must  start  on  the  following  card.  See  chapter  5  for  more  information  on  recording  polygon  labels. 

2.3.2.7  PLOT  OPTIONS 

This  section  is  used  in  the  CHART  program  to  select  various  plot  options  (see  chapter  6). 

2.3.2.8  MOSAIC  OPTIONS 

The  section  is  used  to  specify  options  for  the  overlay  procedure;  see  chapter  7  for  further  information. 


2.3.2.9    POLYGON  SELECTIONS 

A  subset  of  the  polygons  in  a  map-file  can  be  selected  for  processing  by  a  program.  The  selection  is  made  by 
specifying  polygons  to  include  or  exclude.  The  specifications  involve  six  variables:  item  number,  type,  label,  area, 
perimeter,  and  envelope.  Any  combination  of  the  six  may  be  used  except  item  number,  which  must  be  used  alone.  A 
combination  may  involve  both  inclusions  and  exclusions  but  not  on  the  same  variable.  When  a  combination  is  used,  a 
polygon  must  meet  all  of  the  criteria  given  in  order  to  be  selected. 

Entities  are  punched  on  cards  in  the  standard  format  "keyword  =  list". 

The  keywords  are : 

1.  INCLUDE  ITEMS  =  list  of  item  numbers; 

or 

EXCLUDE  ITEMS  =  list  of  item  numbers; 

This  option  is  used  to  select  a  subset  of  polygons  from  a  polygon  map-file  by  explicitly  identifying  polygons  to  be 
included  or  excluded  by  their  item  numbers.  For  example, 

POLYGON  SELECTIONS:  INCLUDE  ITEMS  =  1,10,50,75:80$ 

will  select  a  subset  of  polygons  containing  items  1,10,50,75,76,77,78,79,80.  The  maximum  number  of  items  that  can 
be  included  or  excluded  is  2047. 

This  option  cannot  be  used  with  any  other  options  under  this  section. 

2.  INCLUDE  TYPES  =  list  of  type  numbers; 

or 

EXCLUDE  TYPES  =  list  of  type  numbers; 

This  option  is  used  to  select  points  (TYPE  =1),  lines  (TYPE  =  2),  or  polygons  (TYPE  =  3).  As  of  the  date  this 
manual  was  written,  RID*POLY  was  designed  to  process  only  polygon  data. 

3.  INCLUDE  LABELS  =  label  list; 

or 

EXCLUDE  LABELS  =  label  list; 

This  option  is  used  to  select  a  subset  of  polygons  by  specifying  labels  or  label  components.  If  polygons  are  to  be 
selected  by  labels,  then  the  label  list  should  contain  the  desired  labels.  If  polygons  are  to  be  selected  by  label  com- 
ponents then  the  "#"  (number  sign)  should  be  used  to  mask  unwanted  components  of  a  label.  For  example, 

POLYGON  SELECTIONS:  INCLUDE  LABELS  =  STATE#&620&#$ 

will  select  a  subset  of  polygons  which  has  labels  such  that:  (1)  component  one  begins  with  the  characters  STATE,  (2) 
component  two  contains  only  the  characters  620,  and  (3)  component  three  contains  any  characters. 

4.  INCLUDE  AREAS  GREATER  THAN  =  x; 

and/or 

EXCLUDE  AREAS  GREATER  THAN  =  x; 

This  option  is  used  to  select  a  subset  of  polygons  based  on  their  size.  The  variable  x  is  a  floating  point  number 
representing  acres.  For  example. 
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POLYGON  SELECTIONS:  EXCLUDE  AREAS  GREATER  THAN  =  1000.0$ 


will  select  a  subset  of  polygons  which  has  areas  of  1 .000  acres  or  less. 

5.  INCLUDE  PERIMETERS  GREATER  THAN  =  x; 

and/or 

EXCLUDE  PERIMETERS  GREATER  THAN  =  x; 

This  option  is  used  to  select  a  subset  of  polygons  based  on  the  length  of  their  perimeter  (boundaries).  The  variable 
X  is  a  floating  point  number  representing  feet.  For  example, 

POLYGON  SELECTIONS:  INCLUDE  PERIMETERS  GREATER  THAN  =  2050.0$ 

will  select  a  subset  of  polygons  that  has  perimeter  lengths  greater  than  2.050  feet. 

6.  INCLUDE  RECTANGLE  =  min  x,  max  x,  min  y,  max  y; 

This  option  is  used  to  select  a  subset  of  polygons  that  are  contained  completely  within  a  specified  rectangle  (window). 
The  min  and  max  values  are  integer  numbers  (in  units  of  0.01  inch)  representing  map  coordinates.  For  example, 

POLYGON  SELECTIONS:  INCLUDE  RECTANGLE  =  100,800,500,1000$ 

will  select  a  subset  of  polygons  that  has  only  x  coordinates  between  100  and  800  and  y  coordinates  between  500  and 
1,000. 

2.3.2.10  ENDS 

This  section  is  used  to  signal  the  end  of  control  sections  for  the  map  currently  being  processed.  If  multiple  maps 
are  to  be  processed  in  a  single  run,  the  END$  section  should  be  entered  as  the  last  control  section  for  each  map. 

2.4  Integer  Lists 

Many  programs  will  require  a  list  of  integers,  w'hole  numbers  without  decimal  points,  as  input  from  cards  at  some 
point  (some  header  record  keyw'ords  are  in  this  form).  Rather  than  require  a  fixed  field  size  and  card  location  for  each 
number,  we  use  a  free  format.  The  integers  are  punched  in  as  many  columns  as  are  needed.  Successive  integers  are 
separated  by  commas.  The  list  is  terminated  by  either  a  semicolon  or  a  dollar  sign,  depending  on  context.  Information 
can  be  continued  on  the  next  card  as  if  it  were  one  long  card.  However,  to  facilitate  future  changes,  information 
should  not  be  spanned  across  cards.  Blanks  (skipped  columns)  can  be  inserted  anywhere  except  between  the  digits  of  a 
number. 

Three  abbreviations  are  possible:  (a)  A  sequence  of  increasing  or  decreasing  numbers  such  as  "6,  7,  8,  9" "  can  be 
shortened  to  "6:9".  (b)  A  repetition  of  the  same  numbers,  such  as  "4,4,4,4,4"  can  be  abbreviated  "5(4)".  A  com- 
bination is  possible,  such  as  "2(5,7:9)",  which  is  the  same  as  "5,7,8,9,5,7,8,9".  In  other  words,  whatever  is  inside  the 
parentheses  is  repeated  as  many  times  as  the  number  in  front  indicates,  (c)  For  ease  in  recording  sequences  of  coor- 
dinate pairs,  we  allow^  the  special  forms  <x,a:b>  and  (a:b,y>.  The  lowercase  letters  stand  for  integers.  For  example, 
"<31, 617:653) "  is  the  same  as  "31, 617, 31, 618,..., 31, 653". 

2.5  Comments 

Comments  can  be  included  anywhere  in  the  RID*POLY  cards  by  enclosing  the  comment  material  in  quote 
marks.  A  comment  is  information  that  vou  do  not  want  the  RID*POLY  programs  to  read.  Whenever  a  program  en- 
counters a  quote  mark  in  the  input  stream,  it  scans  forward  until  the  matching  quote  mark  is  found  and  resumes  proc- 
essing at  that  point. 


2.6  Printout 

Certain  information  occurs  on  almost  every  printout  and  may  need  some  explanation.  All  RID* POLY  control 
cards  are  printed  with  the  label,  INPUT  CARD.  This  helps  you  check  your  work  in  case  of  error.  Every  page  printed 
by  a  RID*POLY  program  is  headed  by  the  program  name,  the  date,  time  of  day,  and  a  page  number.  The  message 
END  OF  RUN  is  printed  at  the  end.  Most  of  the  input  information  is  printed  back  as  cards,  showing  you  how  the 
data  have  been  supplied  to  the  computer.  This  helps  you  spot  errors.  Whenever  there  is  an  output  map-file,  the 
message  OUTPUT  FILE  WRITTEN  will  be  printed  after  the  writing  is  complete.  You  need  this  message  to  be  sure  the 
map-file  can  be  read  as  input  in  a  future  run. 

2.7  Limitations 

The  maximum  number  of  polygons  that  can  be  selected  in  the  POLYGON  SELECTIONS  section  is  3,000. 
The  maximum  number  of  labels  that  can  be  selected  in  the  POLYGON  SELECTIONS  section  is  250. 
The  maximum  number  of  points  in  a  polygon  perimeter  is  1 ,991 . 
The  maximum  number  of  polygons  in  a  map-file  is  5,000. 

The  maximum  number  of  polygons  in  an  overlay  map-file  is  5,000  minus  the  number  of  polygons  selected  from 
each  input  polygon  map-file. 

The  maximum  number  of  characters  in  a  label  is  36. 
The  maximum  number  of  label  components  is  10. 
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3.  PREPARING  MAPS 


Proper  map  preparation  is  the  most  important  step  in  the  digitizing  process.  Avoiding  errors  here  has  a  greater 
impact  on  cost  than  at  any  other  stage.  Two  sources  of  errors  can  be  eUrninated:  poor  ink  quahty  and  logical  map 
errors. 

3.1  Automatic  Scanning 

Maps  can  be  drafted  at  any  scale  such  that  after  an  8x  to  1  Ix  reduction  a  photographic  negative  of  the  map  can 
be  obtained  to  fit  the  scanning  bed  or  drum  of  a  mi  erode  nsitometer  (maximum  of  9  inches  by  9  inches  for 
SCANDIG).  Line  w  idth  on  the  m^ap  sheet  should  not  be  wider  than  the  narrowest  gap  beiweeen  lines.  (A  line  width  of 
0.5  mm,  size  of  a  #2  Rapidograph  pen,  on  a  610  mm  by  610  mm  map  has  proved  satisfactory  for  most  applications.) 
The  aperture  setting  (size  of  spot  measured)  on  the  scanner  should  be  half  the  width  of  the  lines  on  the  negative. 

Ink  lines  should  be  of  uniform  width  and  uniform  density.  Moving  the  pen  too  rapidly  along  a  straight  edge  when 
inking  straight  boundaries  produces  a  thin,  weak  line.  A  good  quality  inkingjob  can  eliminate  corrections  in  later 
stages. 

At  this  stage,  common  errors  are  failure  to  label  a  polygon  or  double  labeling  of  a  polygon.  A  polygon  may  be 
double  labeled  because  it  looks  like  two  polygons  or  because  the  line  separating  two  polygons  is  not  inked. 

Maps  to  be  digitized  with  a  scanner  must  be  specially  prepared.  With  a  #2  Rapidograph  pen,  draw  in  black  ink 
the  polygons  to  be  digitized.  Polygons  must  not  overlap  and  should  fiil  the  area  to  be  digitized.  Labels  or  other  map 
features,  if  entered  on  the  map  sheet,  should  be  written  with  a  photo-transparent  blue  pigment  pencil  (EAGLE 
Verithin  nonphoto  blue  740  1/2)  and  thus  will  not  appear  on  the  photographic  negative.  Only  one  layer  of  information 
(attribute)  should  be  entered  per  map  sheet,  for  example,  timber  type,  management  constraints,  or  administrative 
boundaries.  To  completely  till  an  area  with  polygons,  assign  a  special  label  to  all  areas  that  are  not  of  interest.  This 
step  is  critical  for  finding  all  errors  during  the  editing  process.  The  map  must  also  be  free  of  islands  (fig.  3.1).  Remove 
islands  by  connecting  them  to  the  "mainland"  in  two  separate  places  (fig.  3.2).  Eliminaiing  islands  creates  new 
polygons  that  must  be  labeled  with  the  same  label  as  the  polygon  they  were  split  from.  The  new  polygons  should  be 
large  enough  for  a  label  to  fit  inside. 

Complexity  does  not  affect  the  comiputer  time  required  to  process  an  automatically-scanned  map.  The  number  of 
density  readings  that  must  be  taken  on  a  simple  map  are  the  same  as  on  a  '"busy"  one.  On  a  simple  map,  however, 
nearly  all  readings  are  zeros.  Therefore,  a  simple  map  is  relatively  expensive  to  process  by  the  scanner  method,  con- 
sidering the  small  amount  of  information  collected. 

3.2  Manual  Digitizing 

Another  method  of  inputting  data  to  the  RID*POLY  system  is  to  manually  digitize  the  polygon  boundaries.  This 
method  utilizes  a  hand-guided  digitizer  and  a  program  (HANDY)  that  processes  its  output  into  the  same  form  pro- 
duced by  FREQTB  or  BIPRIN.  Because  of  its  limitations,  this  method  is  an  alternative  rather  than  primary  method. 
Users  should  choose  the  scale  and  area  of  their  maps  in  such  a  way  that  most  of  the  work  can  be  efficiently  processed 
by  the  scanning  method,  leaving  only  a  small  part  to  be  hand  digitized. 

No  special  preparation  of  maps  is  needed  for  the  hand  digitizing  process,  but  logical  errors  must  be  avoided.  Tape 
the  map  to  the  digitizer  surface.  Move  the  cursor  over  all  lines  that  are  to  be  recorded.  A  boundary  may  be  recorded 
in  as  many  pieces  (records)  as  necessary  as  long  as  no  gap  is  left  between  pieces.  A  small  overlap  of  x-y  coordinate 
pairs  is  desirable  at  the  end  of  polygon  boundaries  and  T-shaped  intersections.  Point  mode,  recording  only  the  end 
points,  should  be  used  for  straight  lines.  (Point  and  line  mode  are  interchangeable.) 


4.  PROCESSING  INPUT  DATA 


4.1     Processing  Density  Data  (FREQTB) 

FREQTB  reads  density  tapes  produced  by  automatic  scanners,  which  record  image  density  on  a  scale  from  0  to 
63  (using  the  sLx  high-order  bits  of  each  density  reading).  The  program  tabulates  the  frequency  distribution  of  the  den- 
sities and  produces  a  binary  tape.  FREQTB  computes  a  threshold  by  subtracting  the  DENSITY  ADJUSTMENT 
FACTOR  from  the  mode  of  the  density  frequency  table.  Each  six-bit  \  alue  is  conN-erted  to  a  one,  if  below,  or  to  a 
blank,  if  above,  the  established  density  threshold.  The  resulting  matrix  of  binary  \  alues  (binai-v  map)  duplicates  the 
scanned  negative,  with  ones  representing  lines  (low  density)  and  blanks  representing  the  background  (high  densitv). 
The  one/blank  values  are  written  compactly  on  tape  for  use  by  BIPRIN  or  POLLY.  Printed  output  is  a  binar\-  map  in 
which  polygon  boundaries  are  delineated  by  ones. 

There  are  three  versions  of  FREQTB:  FREQl  is  designed  to  process  density  readings  from  a  PDS-lOlOA  scanner 
(Perkin-Elmer  Corportion.  South  Pasadena,  Calif.);  FREQ2  is  designed  to  process  density  readings  from  a  PDS-lOlO 
(old  Berkeley  scanner);  and  FREQ3  is  designed  to  process  density  readings  from  a  SCANDIG  scanner. 

The  FREQTB  routines  are  not  used  ver\'  often  because  it  is  more  efficient  to  produce  a  binary-  file  and  process  it 
through  BIPRIN.  FREQTB  should  be  used  only  for  scanners  that  cannot  produce  a  binar\-  file.  The  IBM  FREQTB 
routines  simply  convert  density  map-files  to  BINARY  map-files,  thus,  they  do  not  follow  the  RID*POLY  program 
conventions. 

Input  cards: 

1 .  System  control  cards  (required).  See  appendix  A. 

//(JOB  CARD) 
/*T0  USPS 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USPS.PR0CLIB,D1SP  =  SHR 

//  EXEC  PROG  =  FREQTBJNTAPE  =  nnnnnnJNLAB  =  n,OUTAPE  =  mmmmmm,OUTLAB  =  m 
//FREQTB.INPUTDD  * 

where: 

nnnnnn  represents  the  volume  serial  number  of  the  tape  that  is  to  be  used  as  input, 
n  represents  the  file  number  to  read  from  above  input  tape. 

mmmmmm  represents  the  output  tape  on  which  the  binary  map-file  is  to  be  written, 
m  represents  the  file  number  to  write  on  the  output  tape. 

(For  further  information  on  FREQTB  procedures  see  appendix  A  and  for  system  cards  see  section  2.3.1.) 

2.  RID*POLY  control  cards 
a.  xxyy  (required) 

XX  -  2  digit  number  which  specifies  the  number  of  maps  to  process  in  the  current  run. 

yy  -  DENSITY  ADJUSTMENT  FACTOR.  Integer  number  between  0-63  used  to  specify  the  cutoff  level 
between  ones  and  blanks  (background)  on  a  binary  map.  If  left  blank,  cutoff  will  be  calculated. 


b.  Header  record,  (required) 

One  card  containing  FOREST,LAYER, MAP, LOCATION ,  and  MODE  =  1 


Sample  Input  Deck: 


/ 


//FREQTB  JOB  (acc.no.„30),NAME,MSGLEVEL  =  (1 ,1),T!ME  =  2 
//PROCLIB  DD  DSN  =  G!NDX.Y1978.USFS.PROCLIB,D!SP  SHR 

//  EXEC  PROG  =  FREQTB,INTAPE  =  CC3930,!NLAB  =  3,0UTAPE  =  CC4530,OUTLAB  =  1 

//FREQTB.INPUTDD  * 

01 

FOREST  =  ST.JOE;  MAP  =  33;  LAYER  =  HABITAT;  LOCATION  =  HAUGAN;  MODE  =  1$ 
H 

4.2    Processing  Binary  Data  (BIPRIN) 

BIPRIN  reads  a  binary  tape  (from  the  SCANDIG  scanner,  the  FREQTB  program,  or  a  previous  BIPRIN  run), 
applies  any  corrections  or  updates  (see  section  4.4,  Editing  a  Binary  Map),  prints  selected  parts  of  the  resulting  binary 
rnap,  and  writes  a  corrected  binary  map-file  on  tape  (if  directed).  BIPRIN  is  very  useful  for  editing  maps  which  re- 
quire many  corrections,  because  (unlike  POLLY)  the  edited  binary  map-file  may  be  kept. 

Input  Cards: 

1.  System  cards,  (required) 

//WRISRUN  JOB  (acc#„30),name,MSGLEVEL  =  (1 ,1),TIME  =  2 
//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCUB,DiSP  =  SHR 
//  EXEC  WRIS,PROG  =  BIPRIN 
//INPUT  DD  * 

2.  RID*POLY  control  cards,  (see  section  2.3  for  exact  formats) 

a.  FILES:  (required) 

The  FILES  section  identifies  the  tape  reels  that  are  to  be  used  for  input  and  output.  An  input  tape  is  required  and 
must  have  the  volume  serial  number  specified.  The  output  tape  is  not  necessary  unless  changes  to  the  binary  map  or 
the  header  record  produce  an  output  map-file  that  is  to  be  saved.  If  an  output  file  is  specified,  then  it  must  specify  the 
volume  serial  number  of  the  tape  used  for  output. 

b.  HEADER:  (required) 

The  HEADER  section  is  used  to  select  a  binary  map-file  for  processing  (see  section  2.3.2.2  for  further  informa- 
tion). MAP,  FOREST,  and  LAYER  are  required  to  locate  the  correct  input  map-file.  They  must  be  specified  exactly 
as  they  were  entered  in  the  HEADER  record  on  the  scanner  output  file. 

c.  HEADER  UPDATES  (optional) 

This  section  is  used  to  add  information  to  the  header  record  or  to  correct  it. 

d.  OPTIONS:  (optional) 

This  section  is  used  to  select  various  features  of  the  BIPRIN  routine.  Available  options  are: 

SKIPS  =  n;  causes  the  input  tape  to  be  positioned  forward  over  n  map-files.  This  option  is  particularly 
useful  when  the  same  identifier  has  been  used  accidentally  in  two  or  more  map-files  on  the  input  tape. 

PRINT  =  CORNERS/ALL/NONE;  indicates  the  print  output  desired  for  a  binary  map. 

An  alternate  method  of  specifying  map  areas  to  be  printed  is: 

ROWS  =  n1,n2,  n3,  n4; 
COLUMNS  =  m1,  m2,  m3,  m4; 

This  example  would  result  in  two  map  areas  being  printed.  The  first  area  is  bounded  by  rows  nl  and  n2  and  columns 
ml  and  m2.  The  second  area  is  bounded  by  rows  n3  and  n4  and  columns  m3  and  m4.  Up  to  4  areas  can  be  specified 
for  each  map.  If  only  ROWS  are  specified,  a  strip  the  width  of  the  m.ap  will  be  printed,  as  the  COLUMNS  values 
default  to  the  first  and  last  column  values  of  the  map.  Similarly,  if  only  COLUMNS  are  specified,  the  ROWS  values 
default  to  the  first  and  last  map  row  values. 


4.2 


PRINT  =  and  ROWS  =  , COLUMNS  =  are  mutually  exclusive. 

FLIP  =  SIDE/UP;  is  used  to  reverse  a  binary  map  from  side  to  side  or  top  to  bottom.  No  reversal  is  done  if 
FLIP  is  not  in  the  OPTIONS  section. 

THIN/NOT  THIN;  indicates  whether  the  lines  on  the  binary  map  are  to  be  thinned. 

LEAVE  ENDSATAKE  ENDS  indicates  whether  to  remove  ends  of  lines  during  the  thinning  process.  TAKE 
ENDS  should  be  used  cautiously,  as  a  gap  in  a  needed  line  may  be  widened.  An  example  of  a  use  for  TAKE  ENDS  is 
to  eliminate  unintentional  stray  marks  that  show  up  on  the  binary  map.  TAKE  ENDS  is  useless  unless  the  THIN  OP- 
TION is  in  effect. 

ITERATIONS  =  n;  places  a  limit  on  the  number  of  passes  the  line-thinning  routine  makes  over  the  binary 
map.  Very  sloppy  ink  work  on  the  original  map  may  require  five  or  more  iterations.  This  option  is  useless  unless  the 
THIN  option  is  in  effect. 

SWAPXY;  used  to  switch  the  x-y  coordinate  values  in  the  corrections  section.  The  x-y  values  are  switched 
from  column-row  to  row-column  form.  For  example,  90,1500  would  be  switched  to  1500,90. 
Options  can  be  in  any  order  within  the  OPTIONS  section. 
The  following  list  indicates  default  values  for  BIPRIN: 

Option  BIPRIN  default 

SKIPS  0 
PRINT  ALL 

FLIP  Not  flipped 

THIN/NOT  THIN  NOT  THIN 

LEAVE  ENDS/TAKE  ENDS  LEAVE  ENDS 
ITERATIONS  5 

SWAPXY  row-column 
e.    CORRECTIONS:  (optional) 
This  section  is  used  to  make  corrections  on  a  binary  map.  For  further  information  on  correcting  a  binary  map  see 
section  4.4. 

Sample  Input  Deck: 

//JOB  („35),BIPRIN,MSGLEVEL  =  (1,1),T!ME  =  2 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS,PROCLIB,DISP  =  SHR 

//  EXEC  WRIS,PROG  =  BIHRIN 

//INPUT  DD  * 

FILES:  INPUT  =  WRIS01;  OUTPUT=NONE$ 

HEADER:  FOREST  =  ST.JOE:LAYER  =  TENSED  HAB.;MAP  =  2017$ 
HEADER  UPDATES:  FOREST  =  ST.JOE;LAYER  =  HABITAT;MAP  =  59; 
LOCATION  =TENSED$ 

OPTIONS:  NUMBER  OF  MAPS  =  1;  PRINT  CORNERS;  THIN;  ITERATIONS  =  3$ 

See  appendix  F.l  for  the  actual  execution  of  this  job  stream. 
4.3    Processing  Digitizer  Data  (HANDY) 

The  HANDY  program  receives  as  input,  data  written  by  a  digitizer.  Output  is  a  tape  that  appears  the  same  as 
the  output  of  FREQTB;  a  map  scanned  on  a  grid  having  a  spacing  of  0.02  inch.  HANDY  constructs  a  grid  of  that 
spacing,  presets  all  of  its  points  to  the  value  0,  and  then  changes  to  1  all  points  that  a  digitized  line  passes  over.  Thus, 
overlapped  segments  are  merely  redundant.  Any  spur-like  overruns  are  pared  off  during  later  processing. 


Input  cards: 

1.    System  control  cards  (required).  See  appendix  A. 


//(JOB  CARD) 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 
//  EXEC  WRIS,PROG  =  HANDY 
//INPUT  DD  * 

2.     RID*POLY  control  cards.  (See  section  2.3  for  more  information) 

a.  FILES:  (required) 

This  section  is  used  to  identify  the  input  and  output  tapes. 

b.  HEADER:  (required) 

This  section  is  used  to  build  a  HEADER  record  for  the  binary  output  map-file. 

c.  OPTIONS:  (optional) 

SKIP=  n$  causes  the  input  tape  to  be  positioned  forward  over  n  files. 


Sample  Input  Deck: 

//JOB  („35),HANDY,MSGLEVEL  =  (1,1),TIME  =  2 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 

//  EXEC  WRIS,PROG  =  HANDY 

//INPUT  DD  * 

FILES:  INPUT  =  WRIS01;  OUTPUT=NONE$ 

HEADER:  FOREST  =  ST.JOE;LAYER  =  LAND  USE;MAP  =  100; 

LOCATION  =  BUZZARD  ROOST$ 

OPTIONS:  SKIPS  =  1$ 


See  appendix  F.3  for  the  actual  execution  of  this  job  stream. 
4.4    Editing  a  Binary  Map 

Most  binary  maps  will  not  require  extensive  editing  if  spacing,  aperture,  and  "threshold  adjustment"  of  the 
microdensitometer  have  been  properly  selected  and  if  good  quality  maps  were  scanned.  For  these  maps  the 
PRINT  =  CORNERS  option  in  BIPRIN  is  all  that  is  needed  to  get  the  GRID  CONTROL  POINTS  (see  section  5.1). 
A  square  or  rectangular  map  of  good  quality  will  not  require  a  BIPRIN  run  if  the  corners  are  the  four  control  points, 
because  POLLY  automatically  finds  the  corner  points  and  uses  them  as  GRID  CONTROL  POINTS. 
4.4.1     Editing  Guidelines 

The  general  procedure  is  to  mark  all  errors  on  the  computer  printout  (binary  map).  Next,  record  all  corrections 
on  data  forms  for  keypunching.  The  printout  is  a  series  of  vertical  strips,  commencing  with  the  left-most  edge  of  the 
map. 

Visually  scan  each  strip,  comparing  it  with  the  map  or  a  photo  of  the  map  for  errors.  Careful  editing  of  the  print- 
out at  this  stage  will  save  considerable  time  and  cost  later.  Correct  each  error  by  circling  with  a  red  pencil  each  "  1 "  to 
be  deleted  and  circling  with  a  blue  or  green  pencil  each  space  where  a  "  1 "  is  to  be  added.  Put  a  check  in  the  right 
margin  if  one  or  more  corrections  occur  in  a  row.  These  checks  will  help  to  avoid  omissions  at  the  data  recording 
stage.  Blocks  of  10  lines  are  not  printed  if  they  are  blank. 


Follow  these  rules  for  adding  or  deleting  I's: 

1 .  Fill  in  gaps  in  lines  with  as  few  points  as  possible  (fig.  4.1). 

2.  Open  the  gaps  between  close  lying  lines  (fig.  4.2). 


4.4 


Hints  for  editing: 

1.  Construct  "rulers"  consisting  of  the  column  heads  for  each  strip.  Insert  rulers  in  the  printout  at  the  begin- 
ning of  each  strip.  This  helps  to  minimize  the  error  of  forgetting  to  change  rulers  at  the  beginning  of  each  strip.  Row 
numbers  are  printed  along  the  right  side  of  the  strip.  The  strip  number  is  printed  in  a  column  to  the  right  of  the  row 
number. 

2.  Inspect  each  string  of  1  's  for  gaps  in  lines,  small  polygons,  and  areas  with  a  high  density  of  1  's.  The  gaps  are 
potential  areas  for  corrections.  Two  1  's  are  considered  connected  if  they  are  in  adjacent  spaces  either  vertically, 
horizontally,  or  diagonally.  Look  particularly  for  polygons  with  only  a  few  interior  cells.  Such  polygons  are  hard  to 
spot  when  they  are  formed  by  diagonal  connections.  Two  kinds  of  features  that  can  cause  extra  small  polygons  are 
acute  corners  of  a  boundary  with  a  small  interior  angle  and  two  parallel  boundaries  that  are  close  together  on  the  map 
but  not  separate  on  the  printout. 

3.  Because  each  addition  and  deletion  must  be  recorded  and  keypunched,  corrections  should  be  kept  to  a 
minimum. 

4.  Two  polygons  connected  by  a  narrow  neck  on  the  map  may  have  two  different  labels.  Therefore,  take  care 
when  correcting  this  kind  of  gap. 

5.  The  first  two  columns  on  each  strip  are  repeats  of  the  last  two  columns  of  the  previous  strip.  These  columns 
almost  eliminate  the  need  to  refer  to  previous  strips  while  making  corrections.  Any  correction  to  a  repeated  column 
need  only  be  made  once. 

6.  Ignore  stray  1  's  that  result  from  photographing  portions  of  labels  or  specks  of  dirt.  The  POLLY  program  will 
ignore  them.  The  polygon  also  ignores  any  piece  of  a  line  that  is  not  part  of  a  loop.  This  is  proper  if  the  line  was  pro- 
duced by  a  smudge  but  will  result  in  an  error  if  it  is  due  to  a  gap  in  an  inked  line. 

7.  The  printout  should  be  edited  twice,  each  time  by  a  different  person.  Usually,  additional  omissions  will  be 
found  and  the  list  will  lengthen. 
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Figure  4.1. — Example  of  lines  needing  ADDS. 
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Figure  4.2. — Example  of  lines  needing  DELETES. 


4.4.2     Recording  Error  Corrections 

Next  record  the  "add"  and  "delete"  corrections  marked  on  the  FREQTB,  BIPRIN  or  HANDY  printout.  Start  the 
recording  with  a  card  that  identifies  the  adds  and  deletes:  ADDS  =  or  DELETES  =  .  It  is  helpful  to  start  recording 
deletes  at  the  top  of  a  separate  sheet.  Each  strip  has  a  ruler  for  recording  column  numbers.  Look  for  checkmarks  in 
the  right  margin  opposite  rows  needing  correction.  Record  adds  and  deletes  by  row  and  column  on  data  forms; 
examples,  5,62,10,453.  For  convenience  in  subsequent  editing,  start  each  line  with  a  row  entry  and  end  with  a 
column  entry  followed  by  a  comma.  Leave  unused  columns  blank.  In  this  way  an  item  will  not  be  split  between  lines, 
and  no  error  will  occur  if  the  order  of  the  cards  is  changed.  Long  consecutive  lists  of  items  in  one  row  or  one  column 
may  be  added  or  deleted  by  the  following  shortcut  method: 

<R,C1:C2>,  or  <R1:R2,C> 

For  more  information  on  the  shortcut  form  of  recording  integer  numbers,  see  section  2.4. 
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5.  PRODUCING  A  POLYGON  MAP-FILE 


Once  a  map  has  been  digitized  and  condensed  to  binary  form,  it  is  necessary  to  generate  a  file  of  polygons  from  it 
and  to  label  them.  The  POLLY  program  is  used  to  perform  this  task.  This  section  will  describe  the  steps  necessary  to 
set  up  a  POLLY  run  and  edit  the  output. 

5.1  Control  Points 

Control  points  are  reference  points  that  are  used  to  align  the  binary  map,  source  map,  and  absolute  geographic 
location.  Control  points  must  be  recorded  in  three  coordinate  systems: 

GRID  CONTROL  POINTS  are  the  row  and  column  positions  of  the  control  points  in  the  grid  coordinate  system 
of  the  binary  map,  for  example  1100,20. 

MAP  CONTROL  POINTS  are  the  x-y  coordinates  in  hundredths  of  inches  used  to  locate  the  labels  within  their 
respective  polygons,  for  example,  100,100. 

GEOGRAPHIC  CONTROL  POINTS  are  the  latitude  and  longitude  of  the  control  points,  for  example, 
47:30:15.5,115:15:30.20. 

Quadrangle  corners  are  usually  selected  as  control  points,  although  any  other  sharply  defined  locations  will  do. 
These  are  recorded  in  a  clockwise  manner,  starting  in  the  lower  left  corner.  Four  corners  are  the  most  desirable,  but 
three  (or  even  two)  may  be  sufficient.  The  corner  must  be  a  recognizable  point  on  or  within  the  map  boundary,  not 
some  arbitrary  point  on  the  map  sheet.  All  maps  representing  the  same  geographic  area  should  use  the  same  control 
points  to  represent  ground  locations. 

5.2  Recording  Polygon  Labels 

A  label  is  a  string  of  1  to  36  characters  that  identifies  the  attributes  of  a  polygon.  In  order  to  e.xtract  polygons 
from  the  binary  map,  all  polygons  must  be  assigned  a  label  and  an  x-y  coordinate  to  position  the  label  within  the 
polygon. 

5.2.1  Setup 

To  record  the  x-y  position  of  the  labels,  an  axis  must  be  established.  The  length  of  each  axis  must  exceed  the 
largest  map  dimension  expected.  The  vertical  or  "north-south"  direction  is  designed  as  the  y  axis.  The  map  must  be 
positioned  within  the  right  angle  (first  quadrant)  formed  by  the  x-y  axis  so  that  all  points  on  the  map  are  positive, 
nonzero  integers.  The  x  and  y  distances  are  recorded  from  the  origin  in  hundredths  of  an  inch. 

5.2.2  Label  Recording 

Start  recording  labels  and  their  x-y  positions  on  a  new  line  of  the  data  form.  Select  a  coordinate  position  that  is 
centrally  located  in  the  polygon.  Use  a  photo  transparent  pencil  (sky  blue.  Eagle  740-1/2  currently  available  in  GSA 
catalog)  to  check  off  each  label  as  it  is  recorded.  An  entity  consists  of  a  label  followed  by  its  x  and  y  position.  Entities 
are  separated  by  a  comma.  The  last  entity  is  followed  by  a  dollar  sign.  Within  the  entity,  the  three  parts  are  separated 
by  one  or  more  blanks.  The  x  and  the  y  coordinates  are  in  units  of  0.01  inch.  Thus,  24  inches  from  the  origin  is  writ- 
ten as2400.  For  example,  FOREST  900  1 1 00,  RANGE300  420,  FOREST  590  1000; 

These  data  are  written  as  one  long  "stream;"  the  end  of  a  line  on  a  data  form  has  no  significance.  If  an  entity  is 
not  complete  when  the  last  column  is  reached,  it  can  be  continued  on  the  next  line.  However,  it  is  recommended  that 
an  entity  be  entered  on  one  line  and  not  spanned  across  lines.  This  practice  will  facilitate  future  changes. 


5.3    Extracting  Polygons  from  a  Binary  Map-File  (POLLY) 

The  POLLY  program  extracts  polygons  from  the  binary  map-file  by  using  the  label  locations  as  starting  points 
(see  section  5.2.2).  Corrections  to  a  binary  map-file  may  also  be  made  in  POLLY  by  using  ADDS  or  DELETES.  All 
the  polygons  extracted  are  written  on  the  output  tape.  POLLY  will  run  a  batch  of  jobs  when  there  is  a  series  of  control 
cards. 

Input  Cards: 

1.  System  cards,  (required) 

//(JOB  CARD) 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 
//  EXEC  WRIS,PROG  =  POLLY 
//INPUT  DD  * 

2.  RID* POLY  control  cards. 

a.  FILES:  (required)  contains  input  and  output  tape  volume  serial  numbers. 

b.  HEADER:  (required)  contains  forest,  map,  layer,  geographic  control  points,  map  control  points,  grid  con- 
trol points,  location,  scale,  state,  and  zone. 

c.  HEADER  UPDATES:  (optional)  contains  any  changes  in  the  input  header  record  which  should  be  on  the 
output  tape. 

d.  OPTIONS:  (optional) 

SKIPS  =  n;  causes  the  input  file  to  be  positioned  forward  over  n  map-files. 

SWAPXY;  is  used  to  switch  the  x-y  coordinate  values  in  the  CORRECTIONS  section.  The  x-y  values  are 
switched  from  column-row  to  row-column  form.  For  example,  90,1500  would  be  switched  to  1500,90.  The  default  is 
row-column  form. 

CHECK  HOLES;  This  option  causes  the  POLLY  program  to  check  the  binary  map  for  holes  (small  areas 
caused  by  line  intersections)  and  unlabeled  polygons.  However,  the  hole-checking  routine  will  not  be  executed  unless 
all  input  labels  have  been  successfully  extracted  and  the  area  of  the  enclosing  polygon  (perimeter  polygon)  exceeds  the 
area  of  the  enclosed  polygon  by  1  part  in  4000.  Default  is  not  to  check  holes. 

PRINT  ACREAGES;  This  option  will  produce  a  table  of  acreage  figures  for  the  polygons  extracted  in  the 
current  POLLY  run. 

e.  CORRECTIONS:  (optional)  contains  ADDS  and  DELETES  if  any. 

f.  LABELS:  (optional)  Contains  the  labels  with  their  x-y  locations  in  map  coordinates.  If  no  labels  are  pro- 
vided, POLLY  uses  the  upper  left-hand  corner  of  each  polygon  as  a  label  location  and  assigns  the  label  NEEDS 
LABEL  to  each  polygon.  If  this  section  is  included,  the  first  card  must  be: 

LABELS:  LIST  = 

The  labels  must  start  on  the  next  card. 

g.  END$  (required  for  multiple  runs):  This  section  is  used  to  signal  the  end  of  RID*POLY  control  sections 
for  the  map  currently  being  processed.  This  section  is  required  if  more  than  one  map  is  to  be  processed  in  a  single 
run. 
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Sample  Input  Deck: 


//JOB  („100),'POLLY  TEST',MSGLEVEL  =  (1 ,1),TIME  =  5 
//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB.DISP  =  SHR 
//EXEC  WRIS.PROG  =  POLLY 
//INPUT  DD  * 

FILES:  INPUT  =  WRIS01 ;  OUTPUT  =  NONES 

HEADER:  FOREST  =  ST.JOE;  MAP  =  59;  LAYER  =  HABITATS 

OPTIONS:  SKIPS  =  2$ 

HEADER  UPDATES:  FOREST  =  ST.JOE;  MAP  =  59;  LAYER  =  HABITAT; 
LOCATION  =  TENSED; 
'TENSED  HABITAT  ST.JOE' 

MAP  =  059;  FOREST  =  ST.JOE;  LAYER  =  HABITAT;  LOCATION  =  TENSED; 
MAP  CONTROL  POINTS  =  101,117,102,1857,2460,1831,2463,101; 

GEOGRAPHIC  CONTROL  POINTS  =  47:00:00,1 1 7:00:00,47:07:30,1 1 7:00:00,47:07:30,1 16.45:00,47:00:00,1 16:45:00; 

GRID  CONTROL  POINTS  =  39,33,25,876,1 164,892,1 180,54; 

STATE  =  IDAHO;  ZONE  =  3;  SCALE  =  31680;  ENVELOPE  =  98,98,1850,2465$ 

CORRECTIONS: 

ADDS  = 

<1 114,1 16:1 18>,<32,442:444>,<1 172,458:466), <  1174,404:407), 

<  39,8 1 :83 ) ,  <  680:69 1 ,44 )  ,679,45,  <  680:684,46 ) ,  <  1 1 78, 1 57: 1 58 ) , 
1179,152,911,345,(35,286:291  ),912,344,302,604,301, 605,300,606, 

<  298:299,607 ) ,  <  434:437,88 1),<1013:101 5,889 ) ,  1 022,890, 

<  1085:1086,890), (1092:1093,891); 
DELETES  = 

1107,121,(1108,122:123), 

(418,521:522), 

1113,117,(1115,116:118), 

(680:684,45),691, 46,890,81, 890,83,91 1,346,912,345,(509:510,453), 

920,403,547,382$ 

LABELS:  LIST  = 

530  2435  1 760,530  2020  710, 

999  892  486,999  339  1 1 38,999  1 487  1 41 7, 

570  536  870,530  7501140,520  804  1146,530  866  1146, 

530  1 125  1066,570  1 154  999,520  1209  1014,530  1 138  936, 

570  1145  865,530  1121  807,570  1202  822,530  371  1567, 

570  1504  170,530  1381  410,570  1407  441,520  1413  404, 

530  1 409  368,530  1 449  376,570  1 453  422,530  1 533  525, 

530  1690  590,570  1740  641,530  1755  689,570  1824  707, 

530  1859  739,570  1912  761,530  1915  806, 

530  1899  892,520  2035  738,570  2001  878,520  2210  798, 

530  2231  764,530  2146  858,570  2171  846,530  2186  876, 

530  2230  859,570  2255  848,530  2205  974,530  1697  278, 

570  1713  314,530  1761  331,570  1808  342,570  1818  208, 

520  2020  428,570  1934  338,530  1979  158,570  1992  280, 

570  2035  238,530  1895  496,570  1993  499,530  2164  302, 

570  2425  306,530  2318  380,530  2370  327,520  2367  238, 

530  2455  232,570  2330  224,999  2366  160,530  2183  206, 

570  2227  149,570  2431  647,570  2333  840,530  2381  861 , 

570  2338  1070,530  2104  1224,999  2324  1228,530  2436  1392, 

530  2441  1755$ 


5.4    Editing  POLLY  Printout 

A  printout  of  a  normally  terminated  POLLY  run  will  consist  of  the  following  sections: 

1 .  File  names  or  reel  numbers. 

2.  Header  record  input  from  cards. 

3.  Header  record  resulting  from  tape  header  record  merged  with  card  input  record. 

4.  List  of  corrections  for  binary  map: 

a.  Additions  input  cards. 

b.  Sorted  list  of  additions. 

c.  Deletions  input  cards. 

d.  Sorted  list  of  deletions. 

5.  List  of  labels: 

a.  Label  input  cards. 

b.  Sorted  list  of  labels. 

6.  Output  header  record. 

7.  Local  label  list. 

8.  Detailed  list  of  extracted  polygons. 

9.  Summary  record  of  number  and  area  of  polygons. 
10.     Confirmation  of  writing  of  output  file. 

For  the  purpose  of  editing,  this  output  can  be  considered  in  two  groups:  Items  1-5  deal  with  input;  items  6-10  deal 
with  output. 

The  printout  is  organized  for  ihe  use  in  editing  rather  than  as  a  record  of  data.  Errors  during  input  are  usually 
recording,  format,  or  keypunch  errors.  There  are  two  groups  of  errors:  those  that  stop  the  program  and  those  that  do 
not.  It  is  best  to  start  looking  at  the  back  of  the  printout  to  see  if  any  input  errors  hve  stopped  the  program.  A  list  of 
fatal  error  messages  follows: 

CONTROL  CARD  ERROR 

Required  control  sections  are  not  present,  are  misspelled,  or  there  is  a  punctuation  error.  (See  section  2.3.) 
INPUT/OUTPUT  FILE  SPECIFICATION  ERROR 

An  input  file  is  required  and  has  not  been  specified.  (See  section  2.3  for  proper  deck  setup.) 
INPUT  FILE  IS  WRONG  MODE 

A  file  with  the  correct  Forest,  Map  and  Layer,  was  read  but  it  is  the  wrong  mode  for  the  selected  program.  See  section 
2.3.2.2  for  more  information  on  MODE. 

CANNOT  RECOGNIZE  THE  LABEL  nnn 

The  left-hand  side  of  a  header  record  entity  (nnn)  is  misspelled.  (See  Section  2.3) 
INPUT  CARD  ERROR 

The  header  record  card  has  a  format  error.  (See  Section  2.3.) 
TOO  MUCH  DATA  ON  INPUT  CARDS 

The  total  amount  of  data  in  the  header  record  is  more  than  the  program  can  handle.  See  the  programer  responsible  for 
RID*POLY  maintenance. 
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READ  ERROR  WHILE  READING  CORRECTIONS  DECK 


This  error  results  from  format  errors  such  as  missing  or  extra  commas,  extra  brackets,  or  lack  of  a  record  terminator. 
See  the  sections  on  Editing  the  Binary  Map  (section  4.4)  and  on  Card  Formats  (section  2.3). 

CORRECTION  OUT  OF  RANGE  ROW  i  COLUMN  j 

A  row  or  column  exceeds  the  maximum  number  of  rows  or  columns  in  the  map.  The  maximum  are  found  in  the 
header  record  labelled  SCAN  ROWS  and  SCAN  COLUMNS 

CARD  INPUT  ERROR 

This  message  indicates  a  format  error  while  reading  labels.  (See  section  5.2  for  label  format.) 

END  OF  FILE  WHILE  READING  LABEL  DECK 

The  usual  cause  is  a  missing  record  terminator. 

n  IS  TOO  MANY  POLYGONS  FOR  THE  ARRAY  SIZE 

The  label  array  is  not  large  enough.  See  the  programer  responsible  for  RID* POLY  maintenance. 

If  the  POLLY  printout  is  not  terminated  by  one  of  the  preceding  error  messages,  the  following  message  may  ap- 
pear in  the  listing  of  label  input  cards.  (Processing  continues  after  this  error.) 

NO  COORDINATES  FOUND  FOR  THIS  LABEL  nn 

A  recording  or  keypunching  error  has  resulted  in  no  coordinates  being  associated  with  the  label  nn.  This  label  is 
ignored  and  processing  continues. 

The  remaining  error  messages  result  from  logical  errors  in  the  data.  They  are  found  during  the  process  of  extract- 
ing polygons.  The  messages  will  be  interspersed  with  the  detailed  list  of  polygons.  To  be  able  to  correct  logical  errors 
in  the  data,  some  understanding  of  the  polygon  extracting  algorithms  is  needed. 

Figures  5. 1  and  5.2  show  the  results  of  thinning  the  examples  illustrated  in  figures  4. 1  and  4.2.  Figures  5.3 
through  5.7  duplicate  figures  4.1,  4.2,  5.1  and  5.2  with  the  ADD  and  DELETE  corrections  applied. 
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Figure  5. 1. — Results  of  thinning  the  example  in  figure  4. 1  without  mailing  ADDS. 
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Figure  5.2. — Results  of  thinning  the  examples  in  figure  4.2  without  making  DELETES. 
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Figure  5.3. — Results  of  making  ADDS  in  the  examples  in  figure  4.1. 
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Figure  5.4. — Results  of  making  DELETES  in  the  examples  in  figure  4.2. 
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Figure  5.5. — Results  of  thinning  the  examples  in  figure  5.3. 
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Figure  5.6. — Results  of  thinning  the  examples  in  figure  5.4. 


The  polygon  extractor  starts  with  a  label  location  in  the  binary  map.  The  label  location  is  found  in  the  POLLY 
program  by  transforming  the  x-y  label  map  coordinates  into  row-column  grid  coordinates.  Starting  at  the  column  of 
the  label  location,  the  row  is  scanned  to  the  right  until  a  line  is  encountered.  The  line  is  followed  clockwise  around  the 
polygon.  At  any  intersection  the  closest  line  in  the  counterclockwise  direction  is  taken.  The  line  is  followed  until  the 
starting  point  is  reached.  When  a  deadend  is  encountered  the  last  bit  in  the  line  is  eliminated,  and  the  program  at- 
tempts to  continue  following  the  line.  If  the  next  bit  back  along  the  line  is  now  a  deadend  it  is  eliminated.  This  back- 
ing up  continues  until  a  bit  is  found  which  can  continue  the  line  or  until  a  fifth  bit  would  be  eliminated.  When  a  fifth 
deadend  bit  is  encountered  in  a  string  the  program  abandons  the  attempt  to  extract  the  polygon.  If  the  program  suc- 
cessfully returns  to  the  starting  point  it  creates  an  artificial  deadend  by  filling  in  the  row  of  the  label  location  from  the 
starting  point  to  the  label  position.  This  artificial  deadend  is  used  to  detect  multiple  labels  in  a  single  polygon. 

With  the  operation  of  this  algorithm  in  mind,  we  can  describe  the  correction  of  the  data  errors  signaled  by  the 
following  error  messages.  Several  of  the  error  messages  are  followed  by  this  label  printout: 

LABEL  NUMBER  =  n,  LABEL  =  m,  X  =  i,  Y  =  j  MAP  LABEL  =  kkk) 

where: 

n  is  the  position  of  the  label  in  the  input  card  deck, 
m  is  the  position  of  the  label  in  the  local  label  list, 
i,  j  are  the  label  location  in  map  coordinates, 
kkk  is  the  label. 

Error  messages  that  begin  with  10  asterisks  terminate  processing  of  that  polygon,  while  error  messages  with  5 
asterisks  are  warning  messages. 

**********LABEL  LOCATION  OUT  OF  RANGE********** 

When  the  x-y  label  location  in  map  coordinates  is  converted  to  row-column  in  grid  coordinates,  one  of  the  coordinates 
is  outside  of  the  range  1  to  SCAN  ROWS  or  SCAN  COLUMNS.  The  label  printout  following  this  message  locates 
the  label  in  the  card  deck  and  on  the  original  map  so  that  it  can  be  corrected. 

*****THE  FOLLOWING  LABEL  IS  ON  OR  ADJACENT  TO  A  LINE***** 

The  label  location  given  in  the  label  printout  that  follows  this  message  may  be  in  error.  Its  location  near  a  line  may 
also  keep  other  errors  from  being  detected. 

******* ***REACHED  EDGE  OF  MAP********** 

The  scan  to  the  right  has  gone  to  the  last  column  and  has  not  encountered  any  line.  The  label  location  in  the  following 
label  printout  may  have  been  misread  or  improperly  recorded.  When  labeling  a  small  polygon  along  the  top,  right,  or 
bottom  edge,  a  small  error  in  either  map  or  grid  control  points  could  put  the  label  outside  of  the  map  perimeter. 

POLYGON  TOO  LONG.  STOPPED  AT  ROW  i,  COLUMN  j  LABEL  AT  ROW  k  COLUMN  n 

The  polygon  has  more  than  the  maximum  number  of  points  allowed  in  its  border  (see  section  2.7).  The  following  label 
printout  will  locate  the  polygon  on  the  original  map.  The  polygon  must  be  cut  into  at  least  two  smaller  polygons  by 
adding  one  bits  to  the  binary  map  using  correction  cards.  A  new  label  must  be  added  to  the  label  deck  for  each  new 
polygon  created. 


5.12 


**********SCAN  INTERRUPTED  BY  ISLAND********** 


LABEL  AT  ROW  i,  COLUMN  j 


The  polygon  boundar%'  does  no:  enclose  the  label  and  is  therefore  an  island  inside  the  polygon  for  which  the  label  was 
intended.  Find  the  island  using  the  label  printout  that  follows  the  error  message.  Eliminate  the  island  by  means  of  cor- 
rection cards. 


*****DEADEND  ENCOUNTERED***** 
DEADEND  AT  ROW  i  COLUMN  j  X  =  x,  Y  =  y, 
POLYGON  LABEL  AT  ROW  i,  COLUMN  j 


This  is  followed  by  a  label  printout  and  one  of  the  three  following  messages.  If  the  deadend  is  anificial.  the  left  end  is 
near  a  previously  used  label  location,  that  label  is  found  and  this  message  is  printed: 

**********THE  FOLLOWING  LABEL  IS  WITHIN  5  HUNDREDTHS  OF  THE  DEADEND********** 


This  is  followed  bv  a  label  printout.  The  two  labels  are  in  the  same  polygon.  They  can  be  found  in  the  sorted  label  list 
and  on  the  original  map  so  that  the  conflict  can  be  resolved.  If  the  two  labels  appear  to  be  in  adjacent  polvgons  on  the 
map  and  their  label  locations  are  correctly  recorded,  a  gap  in  a  line  may  have  caused  the  thinning  algorithm  to  erase 
the  boundaPv"  between  the  two  polygons. 

If  no  label  is  found  within  0.05  inch  (1.27  mm)  of  the  deadend  it  is  assumed  to  be  a  real,  not  artificial,  deadend. 
In  this  case  a  40-row  b\'  40-column  piece  of  the  binar\-  map  is  printed.  The  piece  is  centered  on  the  deadend.  For  shon 
deadends  this  printout  should  be  sufficient  for  correcting  the  error.  For  more  complex  cases,  the  FREQTB  or  BIPRIX 
printout  will  have  to  be  referenced.  Deadends  less  than  5  bits  long  will  be  eliminated  from  the  boundary  by  the  pro- 
gram and  need  not  be  corrected  with  delete  cards. 

******** **MORE  THAN  4  DEADENDS********** 


The  following  message  is  printed  and  processing  of  this  polygon  is  terminated  when  the  deadend  is  more  than  4  bits 
long: 


**********  DEADEND  AT  BEGINNING  AND  END  OF  POLYGON********** 


When  a  second  label  in  a  polygon  is  on  the  same  row  as  the  first  label,  the  artiilcial  deadend  is  not  see  x  as  a  deadend 
in  the  usual  wav.  This  message  is  followed  by  a  label  printout  for  the  current  label  and  a  label  printout  for  the  label 
within  0.05  inch  (1.27  mm)  of  the  deadend. 

When  POLLY  has  tried  to  extract  a  polygon  for  each  label  read  in.  it  compares  the  number  of  labels  read  with 
the  number  of  polygons  extracted.  If  these  figures  are  not  equal,  the  output  tape  is  written  and  the  run  terminated.  If 
the  figures  are  equal  and  the  area  of  the  enclosing  polvgon  is  within  one  part  in  4.000  of  the  sum  of  the  areas  ot  the 
enclosed  polygons,  the  output  file  is  written  and  the  run  terminated.  If.  however,  a  polygon  has  been  extracted  ior 
every  label  and  some  of  the  area  of  the  map  is  still  not  accounted  for  or  is  duplicated,  a  second  stage  of  processing  is 
entered  if  the  CHECK  HOLES  option  was  specified  (see  section  5.3).  POLLY  fills  in  the  area  of  the  binary  map 
represented  by  each  labeled  polygon.  It  then  searches  the  map  for  remaining  holes.  If  a  one-cell  hole  is  found,  a 
message  is  printed  along  with  the  usual  40  x  40  piece  of  the  binar\-  map.  One-cell  holes  are  due  to  an  error  in  the 
binar\-  map.  which  can  be  eliminated  with  correction  cards.  All  larger  holes  are  given  the  label  NEEDS  LABEL  and 
are  extracted.  If  the  polygon  consists  of  less  than  29  points,  the  40  x  40  piece  of  binary-  map  is  printed  because  most  of 
these  small  polygons  are  due  to  errors  in  the  binar\-  map  that  can  be  corrected.  All  valid  polygons  can  be  properly 
labeled  and  located  in  a  subsequent  run.  If  there  are  islands  in  the  map,  the  process  of  filling  the  island  and  the  sur- 


rounding  polygon  produces  a  hole  where  the  island  belongs.  If  the  area  of  enclosed  polygons  exceeds  the  area  of  the 
enclosing  polygon,  each  polygon  labeled  NEEDS  LABEL  should  be  checked  for  being  an  island  on  the  map.  Islands 
can  be  eliminated  using  correction  cards. 

Occasionally,  due  to  poor  quality  input  or  careless  editing,  a  map  will  have  many  interrelated  errors.  In  such 
cases,  it  is  sometimes  difficult  to  find  the  causes  of  all  the  errors.  It  is  best  then  to  rerun  POLLY  with  as  many  correc- 
tions as  possible.  Many  of  the  remaining  errors  will  disappear  and  the  rest  will  be  easier  to  correct. 
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6.  PLOTTING  A  MAP  (CHART) 


CHART  plots  the  polygons  on  a  digital  plotter,  allowing  a  map  to  be  checked  visually.  The  map  display  consists 
of  polygons  with  their  identification,  x  and  y  scales  in  map  coordinates,  and  a  title  which  is  an  extract  of  the  header 
record. 

Input  Cards: 

1.  System  cards. 

//(JOB  CARD) 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 
//  EXEC  WRIS,PROG  =  CHART 
//INPUT  DD  * 

2.  RID*POLY  control  cards. 

a.  FILES:  (required)  contains  input  tape  reel  number. 

b.  HEADER:  f  required)  contains  forest,  map,  and  layer. 

c.  HEADER  UPDATES:  (optional)  allows  changes  to  be  made  in  the  header  record  for  printer  and  plotter 
output  only. 

d.  OPTIONS:  (optional). 

SKIPS  =  n,  causes  the  input  tape  to  be  positioned  forward  over  n  map-files. 

e.  POLYGON  SELECTIONS:  (optional).  This  section  is  used  to  select  a  subset  of  polygons  from  the  input 
map-file  (see  section  2.3.2.9). 

f.  PLOT  OPTIONS:  (optional)  allows  user  to  specify  the  following  options: 

i.     MAGNIFICATION  =  factor;  this  is  the  amount  of  blow-up  or  reduction  to  be  made  on  the  plotted 
output.  The  default  value  is  a  factor  of  1 .0. 

ii.     PLOT  CONTROL  POINTS:  this  option  is  used  to  plot  hash  marks  at  each  map  control  point  location. 
The  default  is  to  plot  only  the  map  control  points  which  fall  in  the  area  selected  to  be  plotted. 

iii.  This  section  is  used  to  specify  how  a  polygon  is  to  be  identified  on  the  plotted  output.  Polygons  can  be 
identified  by  either  one  of  the  following  methods: 

PLOT  ITEM  NUMBERS;  each  polygon  in  a  map-file  is  assigned  a  unique  number,  refered  to  as  an 
ITEM  NUMBER.  If  this  option  is  specified,  each  polygon  will  be  plotted  with  its  item  number  as  the  label. 

PLOT  LABELS;  if  this  option  is  specified,  each  polygon  will  be  plotted  with  the  label  assigned  to  it  by 
the  POLLY  program. 

PLOT  LABEL  NUMBERS;  each  unique  label  in  a  polygon  map-file  is  assigned  a  number,  referred  to 
as  the  LABEL  NUMBER.  If  this  option  is  specified,  each  polygon  will  be  plotted  with  its  corresponding  label  number. 
PLOT  NO  POLYGON  ID;  this  option  is  used  to  plot  polygons  without  any  identification. 
The  default  is  to  PLOT  ITEM  NUMBERS. 

iv.  PLOT  PERIMETER  POLYGON;  this  option  is  used  to  plot  the  perimeter  polygon.  The  default  is  to 
exclude  the  perimeter  polygon. 

The  perimeter  polygon  is  useful  for  orientation,  particularly  when  a  subset  of  polygons  is  selected  via  the  POLY- 
GON SELECTION  SECTION.  Unless  the  PLOT  PERIMETER  POLYGON  option  is  specified,  only  the  portion 
of  the  map  large  enough  to  encompass  the  selected  polygons  is  plotted.  If  POLYGON  SELECTIONS  and  PLOT 
PERIMETER  POLYGON  sections  both  are  specified,  the  user  must  be  careful  not  to  exclude  the  perimeter  polygon 
in  the  POLYGON  SELECTION  SECTIONS.  For  example:  POLYGON  SELECTIONS:  INCLUDE  ITEMS  =  25, 
26,79:209,290$  PLOT  OPTIONS:  PLOT  PERIMETER  POLYGONS  would  not  result  in  the  perimeter  polygon 
being  plotted  because  the  perimeter  polygon  (item  number  1)  was  excluded  by  the  POLYGON  SELECTION  SEC- 
TION. The  correct  wav  is:  POLYGON  SELECTIONS:  INCLUDE  ITEMS  =  1 ,25,26,79:209,290$  PLOT  OP- 
TIONS: PLOT  PERIMETER  POLYGONS 

V.     THINNING  TOLERANCE  =  X;  this  option  is  used  to  reduce  the  number  of  x-y  coordinates  that  will 
be  plotted  in  the  perimeter  of  a  polygon.  Specifying  a  thinning  tolerance  will  reduce  plotting  time;  however,  it  will  also 
reduce  polygon  resolution. 

The  variable  X  is  a  floating  point  number  and  has  a  default  value  of  0.0  (which  means  no  thinning  is  done). 


vi.     EXCLUDE  BOUNDARIES;  this  option  is  used  to  eliminate  the  polygon  boundaries  on  the  plotted 
output.  The  map  plotted  will  contain  polygon  ID's,  control  points,  and  the  perimeter  polygon  if  it  exists  on  the  input 
file.  The  default  is  to  plot  polygon  boundaries. 


Sample  Input  Deck: 

//JOB  („30),CHART,MSGLEVEL  =  (1 ,1),TIME  =  2 

//PROGLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 

//  EXEG  WRIS,PROG  =  CHART 

//INPUT  DD  * 

FILES:  INPUT  =  WRIS01$ 

HEADER:  FOREST  =  ST.JOE;MAP  =  113;  LAYER  =  LAND  USE$ 
OPTIONS:  SKIPS  =  3$ 

HEADER  UPDATES:  FOREST  =  ST.JOE;  MAP  =  113;  LAYER  =  LAND  USE; 

LOCATION  =TENSED$ 

PLOT  OPTIONS:  MAGNIFICATION  =  .85$ 


See  appendix  F.2  for  the  actual  execution  of  this  job  stream. 


7.  OVERLAYING  MAPS  (MOSAIC) 


MOSAIC  overlays  two  maps  representing  the  same  geographic  area.  The  result  is  a  polygon  map-file  in  which 
each  polygon  represents  the  area  common  to  a  pair  of  polygons,  one  from  each  input  map-file.  (In  mathematical 
terms,  this  overlay  is  the  intersection  of  the  sets  of  points  inside  the  two  input  polygons.)  The  label  of  this  new 
polygon  is  a  concatenation  of  the  two  constituent  labels  separated  by  an  "&" .  (For  example,  if  the  two  constituent 
labels  are  PP/AGSP  and  99*01*55,  then  the  concatenated  label  would  be  PP/AGSP&99*01  *55.) 

If  the  label  of  the  new  polygon  contains  more  than  36  characters,  it  will  be  truncated  to  36  characters.  This  label 
concatenation  process  will  continue  for  each  successive  overlay.  All  such  pairs  of  overlapping  input  polygons  are  proc- 
essed. If  both  input  map-files  completely  cover  a  given  geographical  area  with  polygons,  so  will  the  resulting  map-file. 
"Slivers,"  or  polygons  of  insignificant  size,  are  disregarded.  The  user  can  specify  the  minimum  sliver  size,  minimum 
input  polygon  size,  and  the  minimum  output  polygon  size.  (See  MOSAIC  OPTIONS,  section  7.2.i). 

Polygons  from  either  of  the  input  map-files  can  be  selected  or  excluded  from  the  overlay  process  by  using  the  con- 
ventions described  in  section  2.3.2.9. 

The  resultant  map-file  can  be  written  to  tape  for  later  use.  If  the  output  map-file  is  not  needed,  only  a  table  of 
acreages  showing  the  total  area  for  each  label  pair  can  be  produced. 

Multiple  overlays  can  be  run  in  a  single  job  by  including  a  set  of  RID* POLY  control  cards  for  each  overlay  to  be 
performed  (see  section  7.2.j). 

Input  Cards: 

1.  System  cards,  (required) 

//(JOB  CARD) 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 
//  EXEC  WRIS.PROG  =  MOSAIC 
//INPUT  DD  * 

2.  RID*POLY  control  cards. 

a.  FILES:  (required) 

Contains  input  and  output  tape  reel  numbers. 

INPUT  ONE  =  nnnnnn;-  tape  volume  serial  number  of  first  map-file. 
INPUT  TWO  =  mmmmmm;-  tape  volume  serial  number  of  second  map-file. 
OUTPUT  =  kkkkkk;-  tape  volume  serial  number  of  resultant  map-file. 
Specify  OUTPUT  =  NONE  if  the  resultant  map-file  is  not  wanted. 

b.  HEADER  ONE:  (required) 

Used  to  select  the  first  map-file  for  processing.  FOREST,  MAP,  and  LAYER  must  be  specified. 

c.  OPTIONS:  (optional) 

SKIPS  =  n;  causes  the  first  input  tape  to  be  positioned  forward  over  n  map-files. 

TH I NXY  =  X;  (for  first  map-file) 
This  option  is  used  to  specify  a  thinning  factor  for  the  polygon  perimeter  thinning  routine.  X  is  a  floating  point 
number  with  a  default  value  of  2.0. 

The  THINXY  option  should  be  used  only  to  correct  the  INCOHERENT  OVERLAY  error  message  because  it 
significantly  increases  MOSAIC  processing  time.  The  smaller  the  value  of  X,  the  fewer  points  will  be  thinned  from  a 
polygon  perimeter.  Generally  a  value  of  1 . 75  will  resolve  the  incoherent  overlay  problem. 


d.  POLYGON  SELECTIONS:  (optional) 

This  section  is  used  to  select  a  subset  of  polygons  from  the  first  map-file.  Unwanted  polygons  can  be  deleted  in 
this  section.  (See  section  2.3.2.9.) 

e.  HEADER  TWO:  (required) 

Used  to  select  the  second  map-file  for  processing.  FOREST,  MAP,  and  LAYER  must  be  specified. 

f.  OPTIONS:  (optional) 

SKIPS  =  n;  causes  the  second  input  tape  to  be  positioned  forward  over  n  map-files. 
THINXY  =  X;  (for  second  map-file).  See  section  7.2.c  for  description. 

g.  POLYGON  SELECTIONS:  (optional) 

This  section  is  used  to  select  a  subset  of  polygons  from  the  second  input  map-file.  Unwanted  polygons  can  be  deleted 
in  this  section.  (See  section  2.3.2.9.) 

h.  OUTPUT  HEADER:  (required) 

This  section  is  used  to  specify  header  information  for  the  output  map-file  that  differs  from  the  input  map-files,  namely, 
FOREST,  MAP,  and  LAYER. 

1.     MOSAIC  OPTIONS: 

MINIMUM  INPUT  POLYGON  AREA  =  X; 

This  option  is  used  to  specify  the  minimum  area  which  polygons  from  the  input  map-files  may  contain.  Polygons 
that  have  areas  less  than  the  specified  value  of  X  will  be  excluded  from  the  overlay  process. 

The  variable  X  is  a  floating  point  number  representing  acres.  The  default  value  is  5.0  acres. 

The  MINIMUM  INPUT  POLYGON  AREA  option  is  used  to  screen  polygons  from  both  input  map-files.  If  the 
user  wishes  to  screen  the  input  map-files  separately,  then  the  INCLUDE  AREAS  GREATER  THAN  or  EXCLUDE 
AREAS  GREATER  THAN  options  of  the  POLYGON  SELECTION  section  should  be  used.  However,  the 
MINIMUM  INPUT  POLYGON  AREA  takes  precedence,  therefore,  the  user  must  set  its  value  lower  than  the  values 
of  the  INCLUDE  or  EXCLUDE  options. 

For  example: 

FILES:  INPUT  ONE  =  CC3930;  INPUT  TWO  =  CC7183;  OUTPUT  =  006404$ 
HEADER  ONE:  FOREST  =  ST.JOE;  MAP  =  33;  LAYER  =  HABITATS 
OPTIONS:  SKIPS  =  4$ 

POLYGON  SELECTIONS:  INCLUDE  AREAS  GREATER  THAN  =  15.0$ 
HEADER  TWO:  FOREST  =  ST.JOE;  MAP  =  30;  LAYER  =  STAND$ 
OPTIONS:  SKIPS  =  1$ 

POLYGON  SELECTIONS:  INCLUDE  AREAS  GREATER  THAN  5.00$ 
OUTPUT  HEADER:  MAP  =  33;  LAYER  =  HABITAT/STAND$ 
MOSAIC  OPTIONS:  MINIMUM  INPUT  POLYGON  AREA  =  0.0$ 

In  the  above  example,  the  minimum  acceptable  polygon  size  is  15  acres  for  the  first  map-file  and  5  acres  for  the 
second  map-file.  The  MINIMUM  INPUT  POLYGON  AREA  value  was  set  to  0.0  acres  so  that  it  would  not  override 
the  previous  selections. 
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MINIMUM  OUTPUT  POLYGONS  AREA  =  X; 


This  option  is  used  to  select  a  minimum  size  for  output  polygons.  Polygons,  constructed  during  the  overlay  proc 
ess,  which  have  areas  less  than  the  value  of  X  will  be  excluded  from  the  tabular  output  and  the  output  polygon  map- 
file. 

The  variable  X  is  a  floating  point  number  representing  acres.  X  has  a  default  \"alue  of  5.0  acres. 
MINIMUM  MAP  SLIVER  WIDTH  =X1; 

or 

MINIMUM  GROUND  SLIVER  WIDTH  =  X2; 

A  sliver  is  a  polygon  of  insignificant  size,  generally  long  and  narrow,  which  is  produced  when  polvgon  boundar' 
almost  coincide. 

Either  of  these  options  is  used  to  specify  the  minimum  width  a  polygon  may  have.  If  the  width  of  a  polvgon  is  les 
than  the  specified  value  of  XI  or  X2,  then  the  polygon  is  a  sliver  and  will  be  excluded  from  the  tabular  listing  and 
polygon  output  map-file. 

The  minimum  sliver  width  should  be  specified  in  either  ground  or  map  measurements,  but  not  both.  Ground 
width  represents  the  actual  distance  a  polygon  covers  on  the  ground  and  must  be  specified  in  feet.  Map  width  is  the 
distance  the  polygon  width  covers  on  the  map  and  must  be  specified  in  inches. 

For  example,  if  the  area  within  250  feet  of  a  stream  is  of  interest  to  a  user,  then  MINIMUM  GROUND  SLIVER 
WIDTH  =  250.0;  should  be  specified.  However,  if  the  actual  ground  distance  is  not  known,  then  a  minimum  accept- 
able width  should  be  selected  from  the  map,  for  example  MINIMUM  MAP  SLIVER  WIDTH  =  .04; 

The  default  value  for  sliver  width  is  calculated  by:  sliver  width  =  0.04  *  map  scale/12.0.  For  example,  0.04  * 
126720.0/12.0  =  422.40  feet, 
j.      ENDS  (optional) 

Signals  the  end  of  RID*POLY  control  sections  for  the  current  map.  This  section  must  be  included  if  control  sec- 
tions for  another  map  follow^ 

Sample  Input  Deck: 

//JOB  („50),MOSAIC,MSGLEVEL  =  (1 .1),TIME  =  5 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PR0CL1B,DISP  =  SHR 

//  EXEC  WRIS,PROG  =  MOSAIC 

//INPUT  DD* 

FILES:  INPUT  ONE  =  WIRS01 ;  INPUT  TWO  =  WRIS01 ;  OUTPUT  =  NONES 
HEADER  ONE:  FOREST  =  ST.JOE;  MAP  =  59;  LAYER  =  HABITAT; 
STATE  =  IDAHO;ZONE  =  3S 
OPTIONS:  SKIPS  =  3$ 

HEADER  TWO:  FOREST  =  ST.JOE;  MAP  =  113;  LAYER  =  LAND  USE; 
STATE  =  IDAHO;ZONE  =  3$ 
OPTIONS:  SKIPS  =  3$ 

POLYGON  SELECTIONS:  INCLUDE  AREAS  GREATER  THAN  =  5.09$ 
OUTPUT  HEADER:  FOREST  =  ST.JOE;LAYER  =  HABITAT/LAND  USE;MAP  =  113; 
LOCATION  =  TENSED, 
STATE  =  IDAHO;  ZONE  =  3$ 

MOSAIC  OPTIONS:  MINIMUM  INPUT  POLYGON  AREA  =  2.0; 

MINIMUM  OUTPUT  POLYGON  AREA  =  1.0; 
MINIMUM  GROUND  SLIVER  WIDTH  =  150.0S 


See  appendix  F.5  for  the  actual  execution  of  this  job  stream. 


8.  COMBINING  POLYGON  MAP-FILES  (MERGE) 


MERGE  combines  two  polygon  map-files  into  one  map-file.  This  routine  was  developed  to  aid  in  the  polygon  ex- 
traction process  (POLLY).  Generally,  the  first  pass  through  POLLY  will  result  in  the  extraction  of  the  majority  of 
polygons.  However,  if  all  polygons  are  not  extracted  successfully,  corrections  must  be  made  and  POLLY  rerun  on  the 
entire  map  until  all  errors  are  resolved.  This  process  may  become  expensive  on  large  maps  or  on  maps  that  require 
se\'eral  POLLY  runs.  Thus,  the  following  procedure  can  be  used  to  reduce  the  processing  required  to  produce  a  final 
map-file: 

1 .  Run  the  first  POLLY  and  save  the  polygon  output  map-file. 

2.  Make  the  necessary  corrections  and  rerun  POLLY,  using  only  the  polygon  labels  that  were  not  extracted  in 
the  first  POLLY  run.  Repeat  this  step  until  all  errors  are  resolved. 

3.  After  all  errors  have  been  resolved  in  Step  2.  the  MERGE  routine  should  be  used  to  combine  the  polygon 
map-files  from  Steps  1  and  2  to  produce  a  complete  polygon  map-file. 

Caution  must  be  used  in  the  merging  procedure  discussed  in  the  previous  section.  Since  polygons  are  extracted  in 
two  separate  runs  (Step  1  and  Step  2),  duplicate  labels  within  a  polygon  cannot  be  detected  between  the  two  runs.  The 
polygons  in  Step  2  should  be  edited  carefully  to  avoid  duplicate  labels.  The  MERGE  routine  will  print  a  total  area 
figure  for  all  polygons  contained  in  the  output  map-file.  This  figure  should  be  compared  to  the  area  of  the  perimeter 
polygon.  If  the  total  area  figure  is  greater  than  the  perimeter  polygon  area,  there  are  duplicate  labels  within  a  polygon. 
If  the  total  area  figure  is  less  than  the  area  of  the  perimeter  polygon,  then  some  polygons  have  been  missed  in  the  ex- 
traction process.  In  either  case,  CHART  can  be  used  to  produce  a  visual  display  to  resolve  discrepancies. 

The  perimeter  polygon  for  the  output  map-file  will  be  selected  from  one  of  the  input  map-files.  If  both  input  map- 
fiJes  have  a  perimeter  polygon,  the  perimeter  polygon  from  the  first  map-file  will  be  selected  automatically.  If  the 
perimeter  polygon  from  the  second  map-file  is  wanted,  the  POLYGON  SELECTION  section  should  be  used  to  delete 
the  perimeter  polygon  from  the  first  map-file. 

To  reduce  processing  time  and  cost,  the  first  map-file  in  MERGE  should  contain  the  largest  of  the  two  map-files. 
Generally  this  map-file  will  be  the  polygon  map-file  produced  by  Step  1  of  the  procedure  discussed  above. 


Input  Cards: 

1.     System  cards,  (required) 


//(JOB  CARD) 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 
//  EXEC  WRIS.PROG  =  MERGE 
//INPUT  DD  * 


2.     RID*POLY  control  cards. 

a.  FILES:  (required)  Contains  input  and  output  tape  reel  numbers. 
INPUT  ONE  =  nnnnnn;  -  tape  volume  serial  number  of  first  map-file. 
INPUT  TWO  =  mmmmmm;  -  tape  volume  serial  number  of  second  map-file. 

OUTPUT  =  kkkkkk;  -  tape  volume  serial  number  for  output  map-file.  Specify  OUTPUT  =  NONE;  if  the 
resultant  map-file  is  not  to  be  saved. 

b.  HEADER  ONE:  (required) 

Used  to  select  the  first  map-file  for  processing.  FOREST,  MAP,  and  LAYER  must  be  specified. 

c.  OPTIONS:  (optional) 

SKIPS  =  n;  causes  the  first  input  tape  to  be  positioned  forward  over  n  map-files. 

d.  POLYGON  SELECTIONS:  (optional) 

This  section  is  used  to  select  a  subset  of  polygons  from  the  first  input  map-file.  Unwanted  polygons  can  be  deleted 
in  this  section.  (See  section  2.3.2.9.) 

e.  HEADER  TWO:  (required) 

Used  to  select  the  second  map-file  for  processing.  FOREST,  MAP,  and  LAYER  must  be  specified, 
f     OPTIONS:  (optional) 

SKIPS  =  n;  causes  the  second  input  tape  to  be  positioned  forward  over  n  map-files. 

g.  POLYGON  SELECTIONS:  (optional) 

This  section  is  used  to  select  a  subset  of  polygons  from  the  input  map-file.  Unwanted  polygons  can  be  deleted  in 
this  section.  (See  section  2.3.2.9.) 

h.  OUTPUT  HEADER:  (optional) 

This  section  is  used  to  specify  header  information  for  the  output  map-file,  which  differs  from  the  input  map-files, 
namely,  MAP  and  LAYER.  If  this  section  is  not  included,  the  output  header  record  will  be  built  automatically  from 
the  two  input  map-files. 

Sample  Input  Deck: 

//JOB  („50),MERGE,MSGLEVEL  =  (1 ,1),TIME  =  2 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 

//  EXEC  WRIS,PROG  =  MERGE 

//INPUT  DD  * 

FILES:  INPUT ONE  =  WRIS01;  INPUT TWO  =  WRIS01$ 

HEADER  ONE:  FOREST  =  ST.JOE;  MAP  =  59;  LAYER  =  HABITATS 

OPTIONS:  SKIPS  =  3$ 

HEADER  TWO:  FOREST  =  ST.JOE;  MAP  =  113;  LAYER  =  LAND  USE$ 
OPTIONS:  SKIPS  =  3$ 

OUTPUT  HEADER  HEADER:  FOREST  =  ST.JOE;LAYER  =  LAND  USE;MAP  =  113$ 
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9.  MISCELLANEOUS  MAP-FILE  CORRECTIONS  (TONIC) 


TONIC  allows  various  corrections  and  changes  to  be  made  to  be  polygon  map-file. 

Input  cards: 

1.  System  cards.  ^ 

//(JOB  CARD) 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,D!SP  =  SHR 
//  EXEC  WRIS,PROG  =  TONIC 
//INPUT  DD  * 

2.  RID*POLY  control  cards. 

a.  FILESi  (required) 
Contains  input  and  output  file  names. 

INPUT  =  mmmmmm;  -  tape  volume  serial  number  of  the  polygon  input  map-file. 

OUTPUT  =  nnnnnn;  -  tape  volume  serial  number  on  which  the  corrected  polygon  map-file  is  to  be  written. 
If  the  output  map-file  is  not  wanted,  specify  OUTPUT  =  NONE;. 

b.  HEADER:  (required) 

This  section  is  used  to  select  a  polygon  map-file  for  processing.  FOREST,  MAP,  and  LAYER  must  be  specified. 

c.  OPTIONS:  (optional) 

SKIPS  =  n;  causes  the  input  tape  to  be  forward  spaced  n  map-files. 

d.  HEADER  UPDATES:  (optional) 

This  section  is  used  to  make  corrections  or  additions  to  the  header  record. 

e.  POLYGON  SELECTIONS:  (optional) 

This  section  is  used  to  select  a  subset  of  polygons  from  the  input  map-file.  Unwanted  polygons  can  be  deleted  in 
this  section.  (See  section  2.3.2.9.) 

f.  LABEL  COMBINATIONS:  (optional) 

This  section  is  used  to  aggregate  two  or  more  labels  under  a  new  label.  The  format  for  combining  labels  is 
'label  =  list  of  labels'.  The  new  label  is  specified  on  the  left-hand  side  of  the  '  =  '  sign.  This  label  will  be  assigned  to  all 
polygons  that  have  a  label  matching  a  label  specified  in  the  list  on  the  right-hand  side  of  the  '  =  '  sign.  The  label  list 
(right-hand  side)  is  a  list  of  labels  separated  by  commas  and  terminated  with  a  simicolon.  The  last  label  combination 
set  should  be  terminated  by  a  dollar  sign  to  signify  the  end  of  the  LABEL  COMBINATIONS  section.  A  new  label 
(left-hand  side)  cannot  appear  on  the  right-hand  side  of  any  label  combination.  Labels  in  the  list  of  labels  (right-hand 
side)  should  not  appear  in  a  list  of  labels  (right-hand  side)  of  another  label  combination.  For  example,  LABEL  COM- 
BINATIONS: 500  =  510,520,530$ 

This  section  can  be  used  also  to  change  labels.  For  example,  the  label  STATE  can  be  changed  to  STATE  LAND 
by  the  following  control  card: 


LABEL  COMBINATIONS:  STATE  LAND  =  STATES 


g.  NEW  LABELS:  (optional) 

This  section  is  used  to  relabel  individual  polygons.  The  format  is  'item  number,  new  label'.  The  new  label  is 
assigned  to  the  polygon  with  the  specified  item  number.  Each  entry  is  separated  by  a  semicolon  and  the  last  entry  is 
terminated  with  a  dollar  sign  (NEW  LABELS:  2,SPRUCE;6,GRAND  FIR;20,CEDAR$). 

h.  NEW  LABELS  BY  LOCATION:  (optional) 

This  section  is  used  to  assign  a  new  label  to  a  polygon  by  specifying  its  label  coordinates.  (The  label  coordinates  of 
a  polygon  can  be  obtained  from  a  POLLY,  CHART,  or  MOSAIC  job  listing.)  Its  format  is  LABEL  X  y,.  The  x  and 
y  coordinates  should  be  specified  without  decimal  points.  Each  entry  should  be  followed  by  a  comma  and  the  last  entry 
should  be  terminated  with  a  dollar  sign. 

i.  NEW  LABEL  LOCATIONS:  (optional) 

This  section  is  used  to  change  a  polygon's  label  location.  The  format  is  'item  number,  x,y'.  The  polygon  specified 
by  the  item  number  will  have  its  label  moved  to  the  specified  x-y  coordinates.  If  x  and  y  are  zero,  the  label  location 
will  be  computed  automatically.  The  x  and  y  coordinates  should  be  specified  without  decimal  points.  Each  entry  should 
be  followed  by  a  semicolon  and  the  last  entry  should  be  terminated  with  a  dollar  sign, 
j.    STORE  ACREAGESS  (optional) 

This  section  is  used  to  produce  a  list  of  labels  and  their  corresponding  acreages.  The  output  consists  of  a  computer 
printout  and  a  deck  of  cards.  The  card  deck  is  used  by  the  RID*POLY  routine  TALLY  to  provide  tabulations  of 
acreage  figures.  This  deck  can  be  put  on  tape  or  disk  by  changing  the  //FT07F001  JCL  statement.  (See  the  programer 
responsible  for  maintaining  RID* POLY  at  your  installation.) 

NOTE:  This  section  contains  no  entries,  thus  STORE  ACREAGES  is  followed  by  a  dollar  sign. 
Sample  Input  Deck: 

//  JOB  („45),TONIC,MSGLEVEL  =  (1 ,1),TIME  =  2 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 

//  EXEC  WRIS,PROG  =  TONIC 

//INPUT  DD* 

FILES:  INPUT  =  WRIS01 ;  OUTPUT  =  NONES 

HEADER:  FOREST  =  ST.JOE;  MAP  =  59;  LAYER  =  HABITATS 

OPTIONS:  SKIPS  =:3S 

HEADER  UPDATES:  FOREST  =  ST.JOE;  MAP  =  59;  LAYER  =  HABITAT; 

LOCATION  =TENSEDS 

LABEL  COMBINATIONS:  500  =  410,520,530S 

NEW  LABELS:  2,PVT;  3,880S 

NEW  LABELS  BY  LOCATION:  999  1487  1417,  998  339  1 138S 
NEW  LABEL  LOCATIONS:  4,1480,1410;  11,340,1140S 

See  appendix  F.8  for  the  actual  execution  of  this  job  stream. 
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10.  UNIVERSAL  DATA  EXCHANGE  FORMAT  (XCHG) 


A  universal  data  exchange  format  has  been  designed  to  facilitate  the  transfer  of  information  between  polygon- 
based  geographical  information  systems  within  the  Forest  Service.  The  RID* POLY  program  XCHG  will  convert  a 
RID*POLY  polygon  map-file  into  the  universl  data  exchange  format.  (See  appendix  B.4  for  exchange  format.) 

The  following  system  and  RID*POLY  control  cards  are  required  to  execute  XCHG: 

1.  System  cards. 

//(JOB  CARD) 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 
//  EXEC  WRIS,PROG  =  XCHGJAPEOUT  =  mmmmmm,FILENUM  =  m1, 
//NAME  =  location. layer 
//INPUT  DD  * 

where: 

mmmmmm  is  the  volume  serial  number  of  the  tape  on  which  the  universal  data  exchange  information  will  be 
written. 

ml  is  the  file  position  on  the  output  tape. 

location. layer  is  the  name  that  will  be  assigned  to  the  data  exchange  file.  This  name  should  contain  information 
which  will  identify  the  file,  such  as  location  and  layer  separated  by  a '.' ,  for  example,  HAUGAN. HABITAT.  This 
name  must  not  contain  any  special  characters. 

2.  RID* POLY  control  cards. 

The  following  list  contains  all  possible  control  sections  for  the  XCHG  program.  (Refer  to  chapter  2  for  more  in- 
formation on  a  specific  control  section.) 

a.  FILES:  (required) 

This  section  is  used  to  select  the  input  tape. 

b.  HEADER:  (required) 

This  section  is  used  to  select  the  polygon  map-file  from  the  input  tape.  FOREST,  MAP,  and  LAYER  must  be 
specified. 

c.  HEADER  UPDATES:  (optional) 

This  section  is  used  to  make  changes  to  the  header  record.  Any  changes  made  in  this  section  will  appear  on  the 
computer  printout  and  the  universal  exchange  output,  if  applicable. 

d.  (OPTIONS)  (optional) 

This  section  is  used  to  select  any  of  the  following  options: 

SKIPS  =  n;  where  n  represents  the  number  of  map-files  to  skip  on  the  input  tape. 

TRIM;  This  option  will  orient  the  polygon  map-file  such  that  the  minimum  x  and  y  coordinates  are  1 .  The 
default  value  is  TRIM. 

NOTRIM;  This  option  will  not  reorient  the  x  and  y  coordinates  from  the  polygon  map-file. 
NOLABELS;  This  option  will  suppress  label  information  from  being  written  to  the  data  exchange  file.  The 
default  is  to  write  label  information. 

e.  POLYGON  SELECTIONS:  (optional) 

This  section  is  used  to  select  a  subset  of  polygons  from  the  input  map-file  (see  section  2.3.2.9). 

f.  EN  D$  (required  for  multiple  jobs) 

This  section  is  used  to  signal  the  end  of  control  sections  for  the  map  currently  being  processed. 
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Sample  Input  Deck: 


//JOB  („35),XCHG,MSGLEVEL  =  (1 ,1),TIME  =  2 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 

//  EXEC  WRiS,PROG  =  XCHG 

//WRIS.FT11F001  DDSYSOUT  =  A 

//INPUT  DD  * 

FILES:  INPUTS  WRI§01$ 

HEADER:  FOREST  =  ST.JOE;LAYER  =  HABITAT;MAP  =  59$ 
HEADER  UPDATES:  FOREST  =  ST.JOE;LAYER  =  HABITAT;MAP  =  59 
LOCATION  =  TENSED$ 
OPTIONS:  SKIPS  =  3$ 

POLYGON  SELECTIONS:  INCLUDE  ITEMS  =  2:8$ 

See  appendix  F.9  for  the  actual  execution  of  this  job  stream. 
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11.  RID*POLY  TO  RID*GRID  CONVERSION  (PGRID) 


The  PGRID  routine  converts  a  RID*POLY  polygon  map-file  into  the  RID*GRID  format.  Input  for  PGRID 
consists  of  RID*POLY  control  cards  and  a  standard  RID*POLY  polygon  map-file.  Output  from  PGRID  consists  of  a 
magnetic  tape  file  containing  RID*GRID  "D,E,  and  F' '  cards,  a  magnetic  tape  file  containing  labels  and  a  printed 
summary^  (see  flowchart  0.2).  See  appendix  B.5  for  output  tape  formats. 

The  following  system  and  RID*POLY  control  cards  are  needed  to  execute  the  PGRID  routine: 

1.  System  cards. 

//(JOB  CARD) 

//PROGLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SHR 
//  EXEC  WRIS.PROG  =  PGRID,TP0UT#1  =  nnnnnn,FILE#1  =  n1 , 
//NAME#1  =  'name',TP0UT#2  =  mmmmmm,FILE#2  =  m1  ,NAME#2  =  'name1 ' 
//INPUT  DD  * 

where: 

nnnnnn  is  the  volume  serial  number  of  the  tape  on  which  the  RID*GRID  D,E,  and  F  cards  will  be  written. 
nl  is  the  position  of  the  file  on  the  output  tape. 

'name'  *  is  an  ID  that  will  be  assigned  to  magnetic  tape  file  nl .  This  name  should  contain  information  which  will 
identify  the  file,  for  example,  HAUGAN.H ABITAT.GRID. 

mmmmmm  is  the  volume  serial  number  of  the  tape  on  which  the  labels  will  be  written. 

ml  is  the  position  of  the  file  on  the  output  tape. 

'nameT*  is  an  ID  that  will  be  assigned  to  the  magnetic  tape  file  ml.  This  name  should  contain  information  which 
will  identify  the  label  file,  for  example,  HAUGAN.HABiTAT.GRID. LABELS. 

*NOTE:  name  and  namel  must  follow  the  IBM  dataset  naming  conventions. 

2.  RID*POLY  control  cards. 

The  following  list  contains  all  possible  control  sdections  for  the  PGRID  routine.  (Refer  to  chapter  2  for  a  full  ex- 
planation of  each  item.) 

a.  FILES:  (required) 

This  section  is  used  to  identify  the  input  tape. 

b.  HEADER:  (required) 

This  section  is  used  to  select  the  input  polygon  map-file.  FOREST,  MAP,  and  LAYER  must  be  specified. 

c.  OPTIONS:  (optional) 

This  section  is  used  to  select  the  following  option: 

SKIPS  =  n;  where  n  represents  the  number  of  map-files  to  skip  on  the  input  tape. 

d.  POLYGON  SELECTIONS:  (optional) 

This  section  is  used  to  select  a  subset  of  polygons  from  the  input  map-file  (see  section  2.3.2.9). 

The  first  polygon  on  a  RID*POLY  polygon  map-file  is  usually  a  perimeter  polygon,  which  is  a  special  polygon 
that  encompasses  all  others.  This  polygon  is  not  used  by  RID*GRID;  therefore,  it  is  automatically  deleted  by  PGRID 
if  one  exists.  If  the  perimeter  polygon  is  required,  it  can  be  renamed  (by  the  TONIC  routine)  and  it  will  not  be 
deleted. 

e.  END$  (required  for  multiple  jobs) 

This  section  is  used  to  signal  the  end  of  control  sections  for  the  map  currently  being  processed.  If  multiple  jobs  are 
executed;  all  RID*GRID  output  will  be  written  onto  the  same  tape  file  (logical  unit  1 1)  and  all  label  information  will 
be  written  onto  another  tape  file  (logical  unit  13). 
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Sample  Input  Deck: 


//JOB  („50),PGRID,MSGLEVEL  =  (1 ,1),TIME  =  2 

//PROCLIB  DD  DSN  =  GINDX.Y1978.USFS.PROCLIB,DISP  =  SH 

//  EXEC  WRIS,PROG  =  PGRID 

//WRIS.FT11F001  DDSYSOUT  =  A 

//WRIS.FT13F001  DDSYSOUT  =  A 

//INPUT  DD  * 

FILES:  INPUT  =  WRIS01$ 

HEADER:  FOREST  =  ST.JOE;  MAP  =  59;  LAYER  =  HABITAT$ 
OPTIONS:  SKIPS  =  3$ 

POLYGON  SELECTIONS:  INCLUDE  ITEMS  =  2:8$ 

See  appendix  F.6  for  the  actual  execution  of  this  job  stream. 
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APPENDIX  A.  RID* POLY  PROCEDURE 


//WRIS  PROC    DSN  = 'WRIS. MAPS'  ,FILENUM  =  , 

TP0UT#1  =  ,FILE#1  =  ,NAME#1  =  NULLFILE, 

TP0UT#2  =  ,FILE#2  =  ,NAME#2  =  NULLFILE 
II* *********************************************** 

//*  GENERAL  WRIS  PROCEDURE  * 
II* *********************************************** 

//  EXEC    PGM  =  &PROG, REGION  =900K 

//STEPLIB  DD    DSN  =  GINDX.Y1978.WRIS.LOADLIB,DISP  =  SHR 

//FT03F001  DD    DSN  =  GINDX.Y1978.WRiSDRUM,DISP  =  OLD 

//FT04F001  DD  DUMMY 

//FT05F001  DD    DDNAME  =  INPUT 

//FT06F001  DD    SYSOUT  =  A 

//FT07F001  DD    SYSOUT  =  A,DCB  =  (RECFM  =  FB,LRECL  =  80,BLKSIZE  =  800) 

//FT08F001  DD    DSN  =  GINDX.Y1978.WRIS.SPLANE,DiSP  =  SHR,DCB  =  BUFNO  =  1 , 

//  UNIT  =  („DEFER) 

//FT1 1 F001  DD    VOL  =  SER  =  &TP0UT#1 , LABEL  =  (&FI  LE#1  ,SL„OUT), 

//  DSN  =  &NAME#1, 

//  DOB  =  (BUFNO  =  1 , RECFM  =  FB.LRECL  =  80,BLKSIZE  =  8000), 

//  UNIT  =  (TAPE„DEFER),DISP  =  (,KEEP) 

//FT13F001  DD    VOL  =  SER  =  &TP0UT#2,LABEL  =  (&FILE#2,SL„0UT), 

//  DSN  =  &NAME#2, 

//  DCB  =  (BUFNO  =  1 , RECFM  =  FB,LRECL  =  80,BLKSIZE  =  8000), 

//  UNIT  =  (TAPE„DEFER),DISP  =  (,KEEP) 

//TAPEIN  DD    DSN  =  &DSN,UNIT  =  (TAPE„DEFER), 

//  DCB  =  BUFNO  =  1  .LABEL  =  (1  ,SL),VOL  =  SER  =  C99999,DISP  =  OLD 

//TAPEOUT  DD    UNIT  =  (TAPE„DEFER),LABEL  =  (&FILENUM,SL), 

//  DISP  =  (,KEEP),VOL  =  SER  =  CCOOOO, 

//  DCB  =  (BUFNO  =  1 , RECFM  =  FB,LRECL  =  6000,BLKSIZE  =  6000) 


//PLOTTERC  DD  DUMMY 


A.l 


4 

i; 


APPENDIX  B.  DATA  FORMATS 


B.O    Manual  Digitizer  Input  to  WRIS 


One  of  the  WRIS  programs  (HANDY)  accepts  manually  digitized  map  data  as  an  alternative  to  the  preferred 
method  of  digitizing  maps  by  automatic  scanning.  There  are  many  devices  for  manual  digitizing,  which  raises  the 
danger  of  proliferating  different  formats  for  the  manual  data  and  also  WRIS  routines  for  reading  the  tapes  containing 
the  manual  data.  To  prevent  confusion  we  offer  a  standard  format  for  the  tapes.  Today's  digitizers  contain 
microprocessors  to  control  the  formatting  of  their  output;  we  presume  they  can  be  programed  to  produce  this  standard 
format.  If  not,  the  digitizer  output  will  have  to  be  computer  processed  into  this  standard  format. 

The  WRIS  User's  Guide  section  on  HANDY  is  required  reading  to  understand  the  digitizing  method. 

The  tape  is  written  in  ASCII  code.  Block  size  is  fixed,  but  fixed  at  whatever  length  is  efficient  for  the  digitizer 
being  used.  A  logical  record  does  not  correspond  to  a  block.  The  digitizer  should  write  an  end-of-block  gap  (about  0.75 
inch)  whenever  the  block  size  has  been  reached,  and  then  go  on  to  the  next  block  to  continue  the  logical  record. 

A  logical  record  represents  an  arc  on  the  map  consisting  of  a  series  of  connected  straight  line  segments  recorded 
by  moving  the  cursor  over  them  on  the  map.  The  next  logical  record  starts  when  you  move  the  cursor,  without  record- 
ing, to  another  separate  arc  on  the  map  and  begin  recording  it. 

The  unit  of  measurement  on  the  map  is  0.01  inch.  Digitizer  output  is  in  integer  multiples  of  that  unit.  All  coor- 
dinates must  be  positive. 

The  first  character  in  a  logical  record  gives  its  mode.  That  is,  it  tells  whether  the  record  is  in  "point  mode"  or 
"increment  mode".  In  point  mode  the  digitizer  records  a  series  of  x-y  coordinates.  In  increment  mode  it  records  an 
x-y  point  and  follows  that  with  a  series  of  x  and  y  increments  from  that  starting  point.  The  mode  character  is  1  for 
point  mode,  2  for  increment  mode. 

In  point  mode,  there  follows  after  the  mode  character  a  series  of  x-y  coordinate  pairs,  x  requires  four  digits  and 
so  does  y.  After  a  series  of  such  x-y  pairs,  a  "zero"  point  is  recorded  to  indicate  end-of- record.  To  record  x  =  0  and 
y  =  0  will  require  eight  zeroes  since  it  must  be  in  the  same  format  as  a  real  x-y  pair. 

In  increment  mode  the  mode  character  is  also  followed  by  an  x-y  coordinate  pair,  to  establish  a  starting  point. 
The  coordinate  pair  is  followed  by  a  series  of  digit  pairs,  each  pair  consisting  of  an  increment  digit  for  x  and  one  for  y. 
Thus  an  increment  may  range  from  0  to  9  units.  One  or  the  other  must  be  nonzero,  however,  because  if  both  are 
zero,  that  indicates  the  end  of  a  logical  record;  that  is,  a  pair  of  zeroes  is  end-of-record  in  increment  mode. 

Following  the  end-of-record  indication  in  either  mode,  the  next  record  begins  with  its  mode  character  in  the  next 
character  position.  The  end  of  the  tape  is  indicated  by  a  mode  character  9. 

B.l     Scanner  Data  Formats 

B.  1 . 1     SCANDIG  Binary  Output 

The  first  block  on  a  SCANDIG  binary  tape  contains  92  8-bit  ASCII  codes.  The  format  is: 


0000 


14 
14 

A24 

A24 

14 

14 

14 

14 

14 

14 

14 

14 

14 


sequence  number 

forest 

layer 

map 

bits/pixel 
scan  line  length 
number  of  scan  lines 
threshold  value 


increment 


X  length 
y  offset 
y  length 


B.l 


The  second  and  succeeding  blocks  contain  map  information  in  binary  form  (a  "1"  representing  polygon  bound- 
aries and  a  "0"  representing  the  area  inside  a  polygon).  Each  block  contains  as  many  complete  scan  lines  as  will  fit  in 
a  6000-byte  buffer. 

B.1.2    PASEDENA  PDS  lOlOA  Density  Format 

The  PASEDENA  PDS  lOlOA  scanner  produces  a  density  tape  that  is  processed  by  the  FREQTB  program,  ver- 
sion FREQl.  Each  record  within  a  file  contains  96  bytes  of  scanner  information  and  2*n  bytes  of  density  readings  (n  is 
the  number  of  scan  positions  across  a  map). 

The  number  of  scan  positions  is  calculated  once,  because  it  does  not  change  within  a  file.  The  number  of  scan 
positions  is  calculated  as  follows: 

1.  Concatenate  low  order  6  bits  of  bytes  83  and  84  to  produce  a  12  bit  binary  number,  namely,  byte  83  = 
IOIIOI2  and  byte  84  =  IIOIIO2  concatenated  produces  IOIIOIIIOIIO2  (2936io). 

2.  Subtract  the  12  bit  binary  number  from  4096  to  get  the  number  of  scan  columns. 

The  density  values  are  produced  by  concatenating  the  5  low  order  bits  of  the  first  byte  with  the  high-order  bit 
from  the  second  byte  to  produce  a  6  bit  binary  number.  This  binary  number  is  the  density  reading  for  a  given  scan 
position.  For  example,  if  byte  one  =  IIOIOI2  and  byte  two  =  10011 12,  then  the  density  value  would  be  IOIOII2  or 
43,0. 

The  number  of  scan  rows  is  equivalent  to  the  number  of  records  in  the  file.  Thus,  the  density  readings  should  be 
processed  row-by-row  until  an  end-of-file  is  encountered. 
B.2    Binary  Map-File  Format  (MODE  1) 

The  BIPRIN  program  uses  FREQTB  output  or  binary  data  (from  the  SCANDIG  scanner  or  a  previous  BIPRIN 
run)  as  input  and  produces  a  binary  map-file.  A  BIPRIN  binary  map-file  is  written  in  the  following  format. 


Item 

Length  (words) 

Contents 

NWTOT 

1 

Total  number  of  words  in  the  map-file. 

NH 

1 

Number  of  words  In  header  record. 

HED 

NH 

Header  record. 

NL 

1 

Number  of  words  in  label  array  (always 

3  for  BIPRIN). 

LBL 

NL 

Label  record  (dummy  array  occupying 

3  full  words). 

Nl 

1 

Number  of  words  in  the  INDEX  (equivalent 

to  the  scan  rows  in  a  map). 

INDX 

Nl 

Index,  containing  the  length  of  each 

scan  row. 

Si 

INDX(1) 

First  scan  row. 

S2 

INDX(2) 

Second  scan  row. 

INDX(NI) 

Last  scan  row. 

IOTA 

10 

IOTA  array,  dummy  array  of  10  words 

(not  used  in  IBM  version). 

A  binary  map-file  in  this  format  can  be  recycled  through  BIPRIN  for  further  editing  or  it  can  be  used  as  input  for 
the  polygon  extraction  program  (POLLY). 
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B.3    Polygon  Map-File  Format  (MODE  2) 

All  polygon  map-files  produced  by  POLLY  and  used  by  CHART  and  MOSAIC  are  written  in  the  following 
format: 


Item  Length  (words)  Contents 

NWTOT  1  Total  number  of  words  in  the  map-file. 

NH  1  Number  of  words  in  the  header  record. 

HED  NH  Header  record. 

NL  1  Number  of  words  in  the  label  record. 

LBL  NL  Label  record,  (sec.  B.3.1) 

Nl  1  Number  of  words  in  the  polygon  index. 

INDX  Nl  Polygon  index,  contains  the  length  of 

each  polygon  stored  in  the  file. 

Z.,  INDX(1)  First  polygon  record,  (sec.  B.3.2) 

Z2  INDX(2)  Second  polygon  record. 


IOTA 


INDX(NI)        Last  polygon  record. 
10  IOTA  array,  not  used  for  anything  in 

the  IBM  version. 

B.3.1     Label  Record  Format 

The  label  record  in  a  polygon  map-file  contains  a  list  of  labels  which  are  referenced  by  the  polygon  records.  The 
label  record  is  in  the  following  (packed)  format: 


Item 

NW 

NUMLAB 

LOCLAB(NUMLAB) 
LABELS(N) 


Description 

#  of  words  to  follow  in  label  record. 

#  of  labels. 

LOCLAB(J)  is  the  character  position  of 
the  last  character  of  the  Jth  label. 
Character  array  containing  the  labels, 
(N  =  NW  -  1  -  NUMLAB). 


B.3.2     Polygon  Record  Format 

Each  polygon  record  contains  a  FAX  record,  which  describes  certain  attributes  of  a  polygon,  and  the  x-y  coor- 
dinates of  the  polygon  perimeter.  To  conserve  space,  the  FAX  record  and  x-y  coordinates  are  stored  in  packed  format. 
The  coordinates  are  stored  with  a  x  and  y  coordinate  in  one  word  of  storage  (each  occupies  a  half  word  -  16  bits).  The 
FAX  record  is  stored  in  the  following  format: 


Packed  format 

Unpacked  format 

(stored) 

(usable) 

FAX(1) 

POLYGON  SEQ.NO;  POLYGON  TYPE 

FAX(1)  : 

=  POLYGON  SEQ.  NO 

FAX(2) 

POLYGON  AREA 

FAX(2)  : 

=  POLYGON  TYPE 

FAX(3) 

FAX(3)  : 

=  POLYGON  AREA 

FAX(4) 

POLYGON  LENGTH 

FAX(4)  : 

FAX(5) 

POLYGON  LABEL  INDEX 

FAX(5)  : 

=  POLYGON  LENGTH 

FAX(6) 

X  CO-ORD;  Y  CO-ORD  OF  LABEL 

FAX(6)  : 

=  POLYGON  LABEL  INDEX 

FAX(7) 

MIN  X;  MIN  Y 

FAX(7)  : 

=  X  CO-ORD  OF  LABEL 

FAX(8) 

MAX  X;  MAX  Y 

FAX(8)  : 

=  Y  CO-ORD  OF  LABEL 

FAX(9) 

FAX(9)  : 

=  MIN  X 

FAX(IO) 

=  MIN  Y 

FAX(II) 

=  MAX  X 

FAX(12) 

=  MAX  Y 

FAX(13) 

FAX(14) 

B.3 


B.4    Universal  Data  Exchange  Format 

The  Universal  DATA  EXCHANGE  Format  was  designed  as  a  means  of  transferring  data  from  one  computer  to 
another  without  costly  conversions. 

Even  though  card  image  form  is  not  the  most  efficient,  it  is  universally  acceptable.  The  information  accounted  for 
by  this  format  is:  (1)  header  information,  which  consists  of  literal  and  descriptive  information  about  the  work  area;  (2) 
control  information,  which  is  the  user  identified  control  for  the  data;  (3)  label  information  for  identification  of  the  per- 
tinent digitized  data;  and  (4)  point,  line,  and  polygon  information  for  individual  polygons.  The  header  information  is 
contained  on  two  cards  and  the  control  information  is  two  records  per  card  and  as  many  cards  as  required  to  complete 
the  control  list.  Label  information  is  three  records  per  card  and  as  many  cards  as  necessary  to  complete  the  list.  Point, 
line,  and  polygon  information  is  recorded  on  two  cards;  the  first  showing  pertinent  individual  data  string  characteristics 
and  the  second  giving  the  x  and  y  values  for  points  on  the  string.  Ten  coordinates  per  card  and  as  many  cards  as  re- 
quired will  be  accepted  as  one  data  string. 

Header  Information  -  Record  Type  la 


Columns  Field  description  Format 

1-36  Forest  name  9A4 

37-45  Compartment-Location  2A4,A1 

46-80  Layer  name  or  names  8A4,3A1 

Descriptive  Information  ■  Record  Type  lb 

Columns  Field  description  Format 

1-6  Number  of  polygons  (strings)*''^  16 

7-12  Number  of  unique  labels'^)  |6 

13-18  Scale  (reference  fraction^  I6 

19-24  Number  of  control  points*^'  16 

25-48  Layer  envelope  (X-Y/Min-Maxp  416 

49-54  Area  In  0.01  in^  units  16 

55-60  Number  of  layers  overlaid  16 

61-66  Originating  system  name  A6 


(1)  Must  equal  the  number  of  record  type  4a  cards. 

(2)  Must  equal  the  number  of  labels  (3/card)  on  record  type  3  cards. 

(3)  Denominator  of  scale  (1/24,000  map  =  24000). 

(4)  Must  equal  the  number  of  points  (2/card)  on  record  type  2  cards. 

(5)  MIN  and  MAX  X-Y  of  all  polygons,  excluding  control  points. 

*NOTE:  All  records  are  in  card  image  (i.e.,  80  characters  per  record  in  length)  and  are  blank  filled  when  not  used. 
This  format  is  used  to  transmit  data  on  tape  between  computers. 
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Control  Information  -  Record  Type  2 


Columns 

Field  description 

Format 

1-6 

Map  x-coordinate 

16 

7-12 

Map  x-coordinate 

16 

13-22 

Latitude 

(decimal  degrees)-(0.00001  degree  units) 

no 

23-32 

Longitude 

(decimal  degrees)-(0.00001  degree  units) 

no 

33-38 

Map  X  (next  point) 

16 

39-44 

Map  y  (next  point) 

16 

45-54 

Latitude 

no 

55-64 

Longitude 

no 

*The  number  of  control  points  must  agree  with  the  number  specified  in  column  19-24,  and  Record  Type  la.  When 
column  19-24  in  Record  Type  la  is  zero,  this  record  type  does  not  exist;  when  it  is  not  zero,  two  control  points  are 
entered  per  card. 

Label  information  -  Record  Type  3 

Columns    Field  description  Format 

1-24  LABEL  6A4 

25-48  LABEL  6A4 

49-72  LABEL  6A4 

The  number  of  labels  (3  labels/card)  must  agree  with  the  number  of  labels  specified  in  column  7-12  in  Record  Type 
la.  The  position  of  the  label  in  the  list  indicates  its  label  number  as  described  in  column  11-15  of  Record  Type  4a. 

Polygon,  Point,  Line  Information  -  Record  Type  4a 
Columns  Field  description  Format 


1 

Type,  1  =  point,  2  =  line, 

3  -  polygon 

11 

2-5 

Point,  polygon,  line  number 

14 

6-10 

Number  of  points  in  pt.,  polygon, 

or  line*''' 

15 

11-15 

Label  number 

15 

16-20 

Label  or  point  location 

(MAP  X  coordinate) 

15 

21-25 

Label  or  point  location 

(MAP  Y  coordinate) 

15 

26-30 

Polygon  envelope  (Min-X) 

15 

31-35 

Polygon  envelope  (Min-Y) 

15 

36-40 

Polygon  envelope  (Max-Y) 

15 

41-45 

Polygon  envelope  (Max-Y) 

15 

46-51 

Polygon  area  in  0.01  in^  units 

16 
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(1)    Must  agree  with  the  number  of  points  on  the  following  Record  Type  4b  cards. 


Polygon  or  Line  Cards  ■  Record  Type  4b 

Columns        Field  description  Format 

1-4  X-Y  Map  coordinate  pair  214 

9-16  X-Y  coordinate  pair  214 

17-24  X-Y  coordinate  pair  214 
etc. 


73-80 

There  is  a  maximum  of  10  points  per  card,  each  with  an  x  and  y  value  or  a  maximum  of  20  records  per  card, 
references  to  map  coordinates  are  in  0.01  inch  units. 
B.5    RID*GRID  Magnetic  Tape  Formats 

This  section  contains  format  information  for  the  output  tapes  produced  by  the  RID*POLY  PGRID  routine.  For 
more  information  reference  the  RID*GRID  User's  Manual. 
B.5. 1    D,E,  and  F  Tape  Format 

The  RID*GRID  D,E,  and  F  input  records  are  written  onto  logical  unit  1 1 ,  which  is  assigned  to  a  magnetic  tape. 
The  records  are  80  bytes  long  and  blocked  in  groups  of  80,  DCB  =  (RECFM  =  FB,LRECL  =  80,BLKSIZE  =  8000). 
This  file  consists  of  one  "D"  card,  one  "E"  card  and  a  variable  number  of  "F"  cards.  See  appendix  F.6  for  a  sample 
listing  of  this  file. 
B.5. 2    Label  Tape  Format 

The  labels  corresponding  to  the  polygons  output  onto  logical  unit  1 1  are  written  to  logical  unit  13.  The  length  of 
each  record  is  80  bytes,  however,  only  the  first  36  bytes  are  used  for  label  information.  The  labels  on  this  file  corres- 
pond to  the  list  produced  on  PGRID  printout.  An  example  of  a  label  file  is  given  in  appendix  F.6. 

The  DCB  information  for  this  file  is:  RECFM  =  FB,  LRECL  =  80,  BLKSIZE  =  8000. 
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APPENDIX  C.  METRIC  CONVERSION 


The  RID*POLY  system  is  currently  based  on  the  EngHsh  system  of  measurement.  To  convert  RID*POLY  to  the 
metric  system,  the  changes  Hsted  in  table  C.l  must  be  made. 

In  the  English  version,  map  control  points  (section  3.1)  and  label  coordinates  (section  3.2)  are  recorded  in  hun- 
dredths of  inches.  Thus,  map  linear  units  of  1  inch  are  represented  by  ' '  100' '  on  input  to  POLLY  (SCL  =  0.01).  For 
the  metric  version,  map  control  points  and  label  coordinates  should  be  recorded  in  millimeters.  Thus,  map  linear  units 
of  1  centimeter  would  be  represented  on  input  to  POLLY  by  "10"  (SCL  =  0. 1). 
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APPENDIX  D.  DISTRIBUTION  NOTES  FOR  THE  IBM  VERSION  OF 

RID*  POLY 


The  enclosed  tape  contains  the  IBM  360-370  version  of  RID*POLY.  Included  on  this  tape  are:  FORTRAN  and 
assembly  source  code,  test  data,  and  executable  load  modules  for  all  RID*POLY  programs. 

The  RID*POLY  load  modules  may  be  loaded  directly  onto  an  IBM  360-370  system,  thus  eliminating  the  source 
code  compilation  procedures.  The  load  modules  were  produced  on  an  IBM  360/65  (OS/MVT)  and  can  be  executed  on 
any  IBM  360-370  system  that  is  upwardly  compatible  from  the  360/65.  (The  load  modules  have  been  loaded  and  ex- 
ecuted on  an  IBM  370/145  (OS/VSl)  without  modifications.)  At  our  installation,  plotter  output  is  spooled  to  a  disk 
pack  and  plotted  online.  Other  installations  may  spool  the  plotter  output  to  a  tape  and  plot  offline.  This  difference  may 
require  the  plotter  tape  to  be  initialized  in  the  chart  source  code. 

The  RID* POLY  programs  require  a  direct  access  disk  file  on  which  to  perform  intermediate  data  processing. 
This  file,  GINDX.Y1978.WRISDRUM,  requires  300  tracks  of  space  on  model  3330  disk  pack.  (The  data  set  name 
prefix  "GINDX.  Y1978' '  is  a  convention  used  at  our  installation  for  accounting  purposes  and  may  vary  at  other  in- 
stallations.) Installations  which  have  accounting  procedures  that  are  Input/Output  dependent  should  create  this  file  in 
the  first  BIPRIN  run  and  save  it  for  subsequent  runs.  Installations  with  accounting  procedures  that  are  not  I/O  depen- 
dent may  treat  this  file  as  a  temporary  data  set  for  each  job. 

The  RID*POLY  programs  use  assembly  routines  TREAD  and  TWRITE  to  read  and  write  data  on  standard- 
label  tapes.  The  routines  can  process  any  file  on  a  given  tape  with  only  one  DD  (data  definition)  card  (//TAPEIN  DD 
for  input  and  //TAPEOUT  DD  for  output).  There  is  one  restriction,  however;  all  data  set  names  must  be 
DSN  =  WRIS.  MAPS. 

All  RID*POLY  programs  have  a  data  definition  card  (//FT04F001  DD  DUMMY)  for  logical  unit  four,  which  has 
been  assigned  to  a  dummy  unit.  The  original  UNIVAC  1 108  version  of  WRIS  used  this  unit  for  record  keeping 
during  the  development  phase.  This  feature  was  retained  in  the  IBM  version  for  future  expansion  of  the  system.  Until 
this  feature  is  used,  unit  four  should  be  assigned  to  a  dummy  unit. 

In  files  20  thru  28  on  the  distribution  tape,  TAPEOUT  has  been  assigned  to  dummy  units.  These  units  should  be 
assigned  to  valid  tape  files  at  your  installation  so  that  they  may  be  used  in  subsequent  runs.  All  files  necessary  for 
testing  purposes  have  been  supplied  on  the  distribution  tape.  All  test  files  except  the  initial  BIPRIN  input  file  should 
be  created  and  used  by  the  RID*POLY  programs  at  your  installation  as  a  further  test  of  the  complete  sequence  of 
components. 

The  distribution  tape  is  a  9-track  1600  BPI  standard-label  tape.  The  volume  serial  number  is  WRISOl 
(VOL  =  SER  =  WRISOl).  The  following  paragraphs  briefly  describe  the  data  contained  on  each  file. 
File#l 

DSN:    WRIS. MAPS 

DCB:    RECFM  =  VBS,LRECL  =  6000,BLKSIZE  =  6004 

DESCRIPTION:     Scandig  scanner  binary  map-file.  Test  input  for  BIPRIN  program. 
File  #2 

DSN:    WRIS. MAPS 

DCB:    RECFM  =  FB,LRECL  =  80,BLKSIZE  =  800 
DESCRIPTION:    Digitizer  map  file  for  testing  HANDY. 

File  #3 

DSN:    WRIS. MAPS 

DCB:    RECFM  =  VBS,  LRECL  =  6004,BLKSIZE  =  6008 

DESCRIPTION:     Binary  map-file  produced  by  BIPRIN  which  can  be  used  as  input  to  POLLY. 
File  #4 

DSN:    WRIS. MAPS 

DCB:    RECFM  =  FB,LRECL  =  6000,BLKSIZE  =  6000 

DESCRIPTION:     Polygon  map-file  produced  by  the  POLLY  program  which  can  vbe  used  as  input  to  MOSAIC, 
MERGE,  TONIC,  or  XCHG. 


D.l 


File  #5 

DSN:  WRIS.MAPS 

DCB:    RECFM  =  VBS,LRECL  =  6004,BLKSIZE  =  6008 

DESCRIPTION:  Polygon  map-file  produced  by  POLLY  which  can  be  used  as  input  to  MOSAIC ,  MERGE, 
TONIC,  or  XCHG. 

File  #6 

DSN:  WRIS.MAP§ 

DCB:    RECFM  =  FB,LRECL  =  6000,BLKSIZE  =  6000 

DESCRIPTION:    Dummy  file  to  signal  end  of  tape  for  RID*POLY  programs. 

Files  7  thru  18  contain  the  source  code  for  the  RID*POLY  programs.  They  all  have:  DCB  =  (RECFM  =  FB, 
LRECL  =  80,BLKSIZE  =  12960). 

File  #  DSN 


7 

WRIS. ASSEMBLY. SOURCE 

8 

WRIS. COMMON. SOURCE 

9 

WRIS.  FUNCTION.  SOURCE 

10 

WRIS. HANDY. SOURCE 

11 

WRIS. BIPRIN. SOURCE 

12 

WRIS. POLLY. SOURCE 

13 

WRIS. CHART. SOURCE 

14 

WRIS.  MOSAIC .  SOURCE 

15 

WRIS. MERGE. SOURCE 

16 

WRIS. TONIC. SOURCE 

17 

WRIS. XCHG. SOURCE 

18 

WRIS. PGRID. SOURCE 

File  #19 

DSN:  GINDX.Y1978.WRIS.SPLANE 

DCB:    RECFM  =  FB, LRECL  =  80,BLKSIZE  =  800 

DESC RIPTION :     State  plane  coordinate  transformations  for  POLLY  and  MOSAIC . 

Files  20  thru  28  contain  test  data  for  the  WRIS  programs.  They  all  have:  DCB  =  (RECFM  =  FB, LRECL  =  80, 
BLKSIZE  =  800) 

File#  DSN 

20  WRIS. BIPRIN. TEST 

21  WRIS. HANDY. TEST 

22  WRIS. POLLY. TEST 

23  WRIS.CHART.TEST 

24  WRIS. MOSAIC. TEST 

25  WRIS. MERGE. TEST 

26  WRIS. TONIC. TEST 

27  WRIS. XCHG. TEST 

28  WRIS. PGRID. TEST 
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File  #29 

DSN:  GIXDX.Y1978.\VRIS.LOADLIB 

DCB:    RECFM  =  FB,LRECL  =  80,BLKSIZE  =  800 

DESCRIPTION:    This  file  contains  the  GINDX.Y1978AVRIS.LOADLIB  panitioned  data  set,  which  consists  of  the 
object  modules  for  ASSEMBLY,  COMMON,  and  FUNCTION  and  the  load  modules  for  BIPRIN,  POLLY, 
CHART.  MERGE,  TONIC,  XCHG,  and  MOSAIC.  The  IBM  utility  IEHMO\T  was  used  to  unload  this  PDS  onto 
the  distributon  tape.  File  30  contains  the  JCL  needed  to  load  this  file  onto  disk  using  the  lEHMOVE  utility.  This 
PDS  requires  350  tracks  of  space  on  a  3330  disk  pack. 

File  #30 

DSN:    DSN  =  WRIS.IEHMOVE 

DCB:    RECFM  =  FB.LRECL  =  80.BLKSIZE  =  800 

DESCRIPTION:    This  file  contains  the  JCL  for  the  IBM  utility  lEHMOX'E.  which  will  load  the  PDS 
GINDX.Y1978.WRIS.LOADLIB  (file  29)  onto  disk. 

File  #31 

DSN:    WRIS.PROC.  DCB:  RECFM  =  FB,LRECL  =  80,BLKSIZE  =  800 

DESCRIPTION:  This  file  contains  the  JCL  procedure  required  to  execute  the  RID*POLY  programs.  See  appendix 
A  for  listing. 

File  #32 

DSN:    XVVRIS.  ROUTINES 

DCB:    RECFM  =  FB.LRECL  =  125,BLKSIZE  =  13000 

DESCRIPTION:    This  file  contains  the  RID* POLY  RUNSTREAM  GENERATOR  routines.  They  are  written  in 
WYLBUR  EXEC  language. 

The  following  steps  should  be  followed  to  produce  a  load  module  for  theRID*POLY  system: 

Step  1:     Compile  the  assembly  routines  contained  in  File  #7  and  store  object  module  as  member  ASSEMBLY  in  a 
PDS. 

Step  2:     Compile  the  FORTRAN  IV  subroutines  common  to  all  programs  contained  in  File  #8  and  store  the  result- 
ant object  module  as  member  COMMON  in  the  PDS  created  in  Step  1 . 

Step  3:     Compile  the  FORTRAN  IV'  function  routines  contained  on  File  #9  and  saye  the  object  module  as  member 
FUNCTION  in  the  Step  1  PDS. 

Step  4:     Compile  the  source  code  contained  in  File  ^10.  link  in  the  object  modules  produced  in  Steps  1  through  3, 
and  store  the  resultant  load  module  as  member  HANDY  in  the  Step  1  PDS. 

Step  5:     Repeat  Step  4  for  files  1 1  through  18  and  store  each  under  the  appropriate  name. 

The  above  steps  will  produce  a  RID* POLY  load  module  librar\'  that  is  ready  to  execute.  Each  file  on  the  distribu- 
tion tape  contains  the  JCL  required  to  execute  a  specific  task.  The  JCL  was  designed  to  execute  at  Washington  State 
University  Computing  Center  and  may  require  minor  modifications  to  execute  at  other  installations. 


Table  D.1— Distribution  tape  contents 
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rb 

OA 

80 

12960 

16 

WHIb.  1  UlNlU.bvJUnL'b 

CD 

r  b 

Q  A 
OU 

1 2ybU 

■i  ~i 
1  / 

VVnlb.AL'no.bUUno  t 

o 
o 

PD 

r  b 

RA 
OU 

•\  OQCA 

1  /lybu 

1o 

Wnlb.rvjnlU.bUUnL«t 

CD 

rb 

QA 
OU 

1  OQCA 

i^ybu 

19 

CINDX.Yiy/o. WRIb.br  LANE 

12 

CD 

rb 

OA 

80 

a  r\r\ 

800 

20 

\A/DIC  DIDDIKI  TCCT 

VVnlb.DlrnHN.I  tb  1 

H 

1 

CD 

r  b 

QA 
OU 

Q  AA 

oUU 

21 

\A/DIQ  UAMnV  TCQT 

vVnib.nArNUT .  1  to  1 

■1 
1 

PR 

r  D 

RA 
OU 

RAH 
OUU 

22 

WRIb.rULLY.  1  Eb  1 

c 
O 

C  D 

r  b 

Q  A 

oU 

Q  AA 

oUU 

23 

WRIS.CHART.TEST 

1 

FB 

80 

800 

24 

WRIS.MOSAIC.TEST 

2 

FB 

80 

800 

25 

WRIS.MERGE.TEST 

1 

FB 

80 

800 

26 

WRIS.TONIC.TEST 

2 

FB 

80 

800 

27 

WRIS.XCHG.TEST 

2 

FB 

80 

800 

28 

WRIS.PGRID.TEST 

2 

FB 

80 

800 

29 

GINDX.Y1978.WRIS.LOADLIB 

4111 

FB 

80 

800 

30 

WRIS.IEHMOVE 

2 

FB 

80 

800 

31 

WRIS.PROC 

3 

FB 

80 

800 

32 

XWRIS. ROUTINES 

12 

FB 

125 

13000 

APPENDIX  E.  RID*POLY  RUNSTREAM  GENERATOR 


The  RID*POLY  runstream  generator  is  a  collection  of  interactive  routines  that  generate  job  streams  for  the 
RID* POLY  programs  and  perform  the  necessary  file  maintenance.  Although  the  routines  were  developed  to  operate 
on  the  WYLBUR  conversational  text  editing  and  RJE/RJO  system,  they  could  be  implemented  on  any  computer  in- 
stallation that  supports  interactive  computing  or  conversational  text  editing. 

The  runstream  generator  consists  of  two  types  of  routines,  RID*POLY  routines  and  system  routines.  The 
RID*POLY  routines  set  up  job  streams  for  the  various  RID*POLY  programs,  for  example,  MOSAIC,  POLLY, 
BIPRIN,  etc.  The  system  routines  set  up  job  streams  for  the  file  management  system  programs,  for  instance,  moving  a 
map-file  from  one  tape  to  another  and  deleting  a  map-file. 

The  runstream  generator  routines  require  access  to  a  map-file  data  base  and  a  transaction  file.  The  map-file  data 
base  is  used  to  maintain  a  record  of  all  RID*POLY  map-files.  A  map-file  is  a  tape  data  set  that  contains  map  informa- 
tion in  either  density,  binary,  or  polygon  format.  The  locations  (tape  reel  number  and  file  number)  of  all  map-files 
used  for  input  are  retrieved  from  this  data  base.  The  locations  of  all  output  map-files  are  entered  into  this  data  base. 

The  map-file  data  base  contains  temporary  and  permanent  map-files.  A  temporary  map-file  is  any  file  produced 
by  RID*POLY  program.  Temporary  map-files  are  written  onto  tapes  that  reside  in  a  scratch  pool.  When  a  temporary 
map-file  becomes  final,  the  system  routine  MOVE  is  used  to  copy  it  onto  a  tape  residing  in  the  permanent  tape  pool, 
thus  it  becomes  a  permanent  map-file. 

The  transaction  file  is  used  to  record  all  transactions  that  transpire  during  a  session. 

When  a  user  signs  on  the  system,  control  is  given  to  the  master  routine  (#XWRIS).  This  routine  loads  the  map- 
file  data  base  and  the  transaction  file  onto  primary  storage  (high-speed  direct  access  device).  The  user  is  then  queried 
for  the  name  of  a  program  to  be  run,  for  example,  MOSAIC,  POLLY,  MOVE,  DELETE,  etc.  Once  a  program  has 
been  selected,  its  corresponding  routine  is  loaded  and  control  is  passed  to  it.  The  selected  routine  queries  the  user  for 
information  required  to  set  up  a  runstream.  It  accesses  the  map-file  data  base  for  Input/Output  information  and 
records  the  activity  in  the  transaction  file.  Upon  completion,  the  generated  runstream  is  sent  to  the  batch  processor.  If 
the  user  rishes  to  generate  another  runstream  using  the  routine  that  is  loaded,  control  is  passed  to  the  beginning  of  the 
routine.  Otherwise,  control  is  returned  to  the  master  routine.  At  this  point  the  user  can  either  select  another  program 
or  exit.  Upon  exit,  the  master  routine  copies  the  map-file  data  base  and  the  transaction  file  onto  secondary  storage  and 
the  session  is  terminated. 

The  following  material  is  a  sample  session  in  which  runstreams  are  generated  and  submitted  for  both  WRIS  and 
system  programs. 


EXEC  r-R  in  #:  ('!•■: .i:s 


URIS  RUMSTI-;:i:i  ,h   GENRF^rVl  GR 


TIME        16 1  13  I  I'd  ^    DATR    ••  0'5/07/SO 
ENTER   ACCOUNT   FOR   THIS  SEISSIGNi 

ENTER   THE  USER/GRGUR    INITIAES   GE   THE   DATASETS   YGU   WISH   TG  ACCESS 


S  1     ♦  '..7  *   V           \\  [•• 

Kl  T  M  ^  '»  *     Ti  A  M  T  iM 
1  y  .1.  1  1     /  ♦     k.i  i-  l  I  '!  .1.  1  1 

I"  KJ  T' 1"' l-i    I--  1  'llvl- 
l...  1 X  i  1...  IS     1    y.iW  1... 

v.)  1     1  ij ij    w i-i  1 X  1      1       wijisin    W.I.  Ill*    \.)  1  +     ^.M.J i;_ 

III  l  i'  r       1"'  I'l  i^J  'T'  Iv  l")  1     I"'  I'i'  f  l  r.  Iv  A  M 

W  K  .L  ^.J     K.r  l.J  1  X  1  IV  l.J  1...     I    1  S  L.I  (.)  1  V  1"!  1  1  ♦ 

1...  1 X  1  c.  1  k    1  1 MJ  Ij 

Ki-ill  ^1  U    \...  Al.A.A.)  1  r..     \  L/ls     1  l.J    1...  A  .1.  1           .1.     1  IJ  rv     .1.1x1  l.J  /  o  .1. 

I"'  fi  ll  I  'm  \-y  C\  M 
1    \\\.>  K.i  1  S  11 1  1 

A.'  1...  \./  (../  1  \  .1.  r     1   .1.  K.f  1  X 

1  f  If  ■ATE 

Al  1  GCATES    A    TAPE    I'Rf'lM    THE    bISII    'TAPE    Pl'lfli  . 

\  \  \...  I...  \.}  K./- \  \  1   I.., \J       11        1   1(1     (...       1     1  \  l.J  1  1        1   1  If...       w  \.MJ        1  rll     1...       1         <  J  i...  <■ 

P  !  l-'k  1  N 

R  I  E  E  T  N    I-l'  1 1 N  ^  ■; ']"    I'"  A  M    I'l  I"  h-l  1""  E  A  1 '  I")  R"  . 

A.'   1.  1     1  S  .1.  1  X      1  \  I..*  1  <  ..J  1   1  \  I...  1  1  1  1       K.)  1...  1  \  1...  1  \  1  1   1   l.M  \  ♦ 

f"  w  A  r;'  r 

I"' !  i  A  1^;'  1'    Iv  1  1  Kl     T  Iv  1"'  A  M        I-"  M  I--'  l^i'  A  \ '  l  l  Tl" 
I./ 1  1  ri  rv  1     1  ■%  l.J  rK.)  1  Kl...  i-lli    l.J  l._  i  x  1...  rv  l-i  1  l.JK  ♦ 

DECBACK 

BACKS  UP   EITHER   PGEEY   GR   BIRR IN  DECKS   TG  TAPE. 

DECKRES 

RESTGRES  EITHER   PGEEY  GR   BIRR IN  DECKS. 

DEEETE 

DELETES  A   MAR-FILE  ERGM   A   TEMPGRARY  TAPE* 

LI.i  IT 

EDITS  A   B I  ERIN   GR  PGEEY  FIFE* 

i-IANDY 

H  A  N  D  Y   R  1.1  N  S  T  R  E  A  M   G  E  N  E  R  A  T  G  R  , 

MERGE 

M E R G E S    I  W G  1- G L. Y G G N   MA E  - E  1 L. i: S  . 

M  f1  S  A  T  C 

1  1  \.<  \J  I  I  .1.  K.t 

M  I'l  '''•^  A  T  r    E 1 1  hi    T  E  E  A  M  I" -I  I-'  W  E  E  A  '1  1 ')  E  . 

1  i  l.K.J  1  1  .1.  I./       I\l..'lx%.)   1  1  V  1...  I'  1  1  1      I..' 1...  1  X  1...  1  \  1  1   1   \.lt\  ♦ 

MGUE 

MGUES   A   MAP -FIEF  ERGM  A   TEMPGRARY   Tu   A   I'ERMANENT  TAL'E. 

PGR  ID 

UIRIS   TG   GRID   DATA  CGNUERTER* 

E'Ml  1  Y 

i  I J 1...  i._  i 

r '  (']  1  1  Y    R 1  1 M  S  T  E  F  A  M    I  'i  I-'  i\J    I-l"  A  T  I'  1  I-i'  . 

1    K.H...\...  1       (  k  L>  1  V       1  i  V  1...  1  1 1  i          1...  1  X  1...  1  \  1  1  1  (.>\  \  ♦ 

\\\-.  L.  E  i-i  b  r. 

........  .................     .    .............    y  ifv,..           -i"  1  1  r"    1  1    1  1    i" '\  1 "' I""    r- fl  ri  1 

K  1:;.  L.  1::.  r-K:>  1::.  ^:)    i-l     1  i-i|- !::.    l.<i-U..  I\     ill     Mil.:.    WJ.)l.i     i  i-^r- 1;:.    r  l..ll.Jl...  ♦ 

TON  I C 

J  G  N  :i:  c  R  u  N  i'  i-;;  e  a  m     n  l:  i-;;  a  r  g  r  . 

XCHG 

X  c  Ll  g  r  1. 1 N  s  r  f;;  l;  a  m  g  e  n  e  r  a  t  g  r  . 

ENTER  PROG 

RAM   TG   EXECUTE    (CP   TG   EXIT?    -I   EGR   I NEC) J    BIRR IN 

t  >{< 

BIRR  IN   RUN  STREAM  GENERATGR          )i<   >K  )K 

layer:  HAb 

I  T  AT 

!..  GCATI GN: 

TENSED 

•  TAPE-    WR 1 

SO  I 

LAB   M  LURE 

sr           MAP#  PAYER                                     LGCATIGN  .nATE 

3        I   ST.JGE  59  HABITAT  TENSED  04/2 3/ SO 

IS   THIS   THE  MAP  ••FIEF   YGU   WANT?  NO 

"HABITATy    TENSED"    CGULD   NOT  BE  FGUND   IN   THE    "STJGEEuG"  FIFE* 
DG   YGU  WISH   TG   TRY   ANGlHER^i^  GK 
PAYER;    l  ENSFii   HAB  > 

eocatign:  tensed 


E.2 


-TAPE-  URISOJ. 
LAB   H   F- OR  ES  T 


MAP#  LAYER 


LGCA  n ON 


DATE 


1        1   Si ♦JOE  2017   TENSED  NAB*  TENSED  04/23/00 

T  >   THIS   THE  MAP -PILE   YOO  WANT?  YES 

J'O   YOU   WANT    iu   UPDATE   THE   HEADER  RECORD'!^  OK 

ENTER   THE   EOLLGWINO    .1.  NEORM  A !  J.  ON   AS    YOU   WOULD   LIKE    IT   TO   APPEAR  IN 
THE  OUTPUT  MAP-PILE. 

f  i.)  R  i;;:  s  t  (max  i  o  o  i-  i  a  r  s  >  t  s  r  *  j  o  i;;: 

LAYER    (MAX   24   CHARS*):  HABITAT 
I. .  0  C:  A  T 1 0  N    (MAX   :l.  6   0 II A  R  S.)  t    J  E  N  S  E  D 

MAP  number:  ^:^9 

t   t   YOUR  MAP-PILE   WILL  BE  WRITTEN   TO  >KWRISI2y    LABEL  I* 

(jpFioNS  section: 


DO  YOU  WANT  TO   PRINT  CORNERS  y    ALLy    NONEy    OR  WINDOW^i^  CORNERS 

DO  YOU  WANT   TO   THIN   THE  BINARY  MAP?  YES 

NUMBER  OE  PASSES   POP   THINNING:  3 

DO  YOU  WANT    TO  PL  IP   THE   BINARY   MAP'i'  NO 

L N T' i;;: r  m m b i: r  in  " b :i: p r n d k s  "  w i-i i;;: r i;;:  c; o r r e c j i o n s  a r i:  ( c r  •  n g n t;: ) : 

no  YOU  WANT    TO  ENTER  ANY  CORRECTIONS?  NO 
DO  YOU  WANT  A  LIST  OE  THE  RUNSTREAM^I^  OK 

B I PR IN  RUNSTRPAM 

/    W   I S  R  U  N   JOB    (  y  y    0  )  y  B I R  R 1 N  y  M  S  G  I...  E  U  F- 1...    (  I  y  I  )  y  T 1 M  E  ■■■■■■■  5 
/  /  P  R  0  C  I..  I B  D  D   D  S  N  ■■■■■■  G I N  D  X  .  Y 1 9  7  S  *  U  S  E  S  .  P  R  0  C  I...  :i:  B  y  D :[  S  F-'  ■■■■^  S  F  l  R 
/  /   E  X  E  C   W  R I S  y  P  R  0  G   B 1 P  R 1 N  y  E  1 1...  li:  N  U  M  ■■^  1 
//INPUT   DD  t 

I-  T  I...  E  s :  I N  F--  u  I  w  R I  s  0  :i.  y  0  u  r  I-"  u  7  W  R 1 S 1  2  $ 

I  -I  E  A  D  E  R  t    E  0  R  E  S  T  S  T  .  J  0 1:  ?  1...  A  Y  E  R  ■■■■^^  J  E  N  S  E  D  I  I A  B  *  ?  M  A  I-"  ■■■^  2  0 1  7  % 
HEADER   UPDA  I  ES  :    LORES T^^^ST  ♦  JOE  ?    LAYERS-HABITAT  ?    MAP^^^s^y  y 
LOCAT I  ON=::mENSED$ 

0  F-*  T"  1 0  N  s :  N  u  M  B  E  R  0  E  M  A  p  s  1  ?  p  R 1 N  T  c  0  R  N  f:  r  s  ?  \  F  l  :f  n  y  :f  t  f;:  r  a  I' ;[  0  N  S  3  $ 

Ok  to  run?  ok 

priority:  delay 

job         4338  wrisrun    sent  to  jes2. 

do  you  want  to  run  another  "biprin"  job'i'  no 

wris  control  program » 

i:;:  n  t  e  r  p  r  o  g  f;:  a  m  t'  o  f;:  x  f-  c  u  t  e  ( c  r  j  g  f-  x  :i:  t  ?  -  :i.  e  o  r  j:  n  f-  o  ) :  g  f  i  a  r  t 

>{<){<*   )i<   >{<     CHART   RUN  SI  REAM   GENERATOR  ;K 

MODE    -   2) POLLY   OR   3) MOSAIC i  2 
layer:    LAND  USE 

location:  tensed 


E.3 


LGCAT I GN 


5  2   ST.  JOE  :l.  :l.:->  land   use  tensed  04/23/80 

IS  THIS   THE  MAF" -EILE   YGU  UANT'I^  YES 

DO  YGU   WANT   A  l""LGT?  GK 

DU  YGU   WANT    iG   SPECIi~r   ANY  PLOT  GF'TIGNS'i^  GK 

(J  !■  ■  r  1 0  N  s :  :i. )  M  A  N  ;i:  f'  i  c  a  \  i  g  n  e  a  g  j  g  r 

2)  PLGT   GGNTRGL  PGINTS 

3)  PGLYGGN  LABELING 

4)  PLGT  PERIMETER  PGLYGGN 

ENTER   PLGT   GPTIGN  NUMBER    (GR    ••   EXIT):  I 
ENTER  MAGNIPICATIGN   EAGTGR:  *85 

ENTER  PLGT  Gf-' 1  IGN   NUMBER    (GR   -  EXIT): 

DG   YGU   WISH   TG   SELL GT  A   SUBSET   GE   PGLYGGNS^i^  NG 

DO  YGU   WANT   A   MYLAR  PLOT?  NG 

DG   YGU  WANT   A   LIST   GP   THE  RUN  STREAM'!  YES 

CHART  RUNSTREAM 

/ / W R I S R UN   JOB    (  y  y  9 9 9 9  )  y  G Fl A T  y  M S G L E "v' E I... -  (  I  y  ;l.  )  y  T 1 M E ■■■■■■■  "5 

//PRGCF  I  B   DD   DSN-G I NDX  .  Y 1 97S  *  USES  ♦  F'lxGCL  I B  y  D I  SP^^^^SHR 
//  EXEU  WRISypRGG-CFIART 

/  /  P  I...  G  r  T  E  R  C   n  B   S  Y  S  G  U  T    (Q^P  I...  G  J  W  T  R  y  W  T  F  )  y  D  E  S  T  ■■■■■  E  C  C  A  I... 

//INPUT   DD  t 

r ILES:    INPUT- WR ISO I  $ 

l-l  E  A  D  F:  R  t    E  0  R  E  S  T  r----  S  T  .  J  G  E  ?    M  A  F-'  ■■■■■  1 1  3  y    I...  A  Y   R  ■■■■■■■  I. .  A  N  D  U  S  F:  $ 

l-l  F"  A  D  i;:  R   U  !•■■  D  A  J  E  S  ^    !••  G  R  E  S  i '  ■■■■■■  S  J  .  J  G  E  ?    M  A  I-'  ■■■■■■  1 1  3  ?    I...  A  Y  F.  l-(  ■■■■■■■  E  A  N  D   U  S  E  ? 

LuCATI  GN==^TENSED$ 

OPTIONS;    SKI  PS- 4$ 

E '  0  7'  0  p  T  :i:  0  N  s :    m  a  n  :i:  i-  i;  c  a  r  i:  o  n  ■■■■■■■  ♦  e  5  $ 

ok  to  run'!^  gk 
priority :  delay 

..job  --  4347  wrisrun    sent  tg  jes2. 

dg  ygu  want  to  run  another  "chart"  jgb'i^  no 

wris  con i pol  program* 

fnter  program  to  execute  (cr  tg  exit?  -i  egr  ineg):  handy 
>!.>{<){<){<){<    handy  runstream  generator    )}<     ){<  >!< 

layer:  land  use 
location :  buz/ard 

•tape-  wrisoi 

lab  m  eg rest        map#  layer  location  date 


2     5  '  i  J .  J  0  F  :i.  0  0  I...  A  N  i  1  u  E  B  u  / : ,  I R  D    0  L !  ^-  r       o  4  /  2  3  o  (; 

IS   THIS   THE   MAP--PIF.E   YGLI   WANT'^  YES 


E.4 


I'D   YGU   ujANT    lii   UI-'DAIE    IHE   HEADEFC   REuUI-^D?  NU 


;«   )«   )^   YUUFC   MAP-FIEE   WJEE   BE   WF^[TTEN   TG   ;!<WF^i:S;L3y    EABEE  1. 
DG-  YGU   UANT   A   EI  ST   GF   TFIE   F(  UN  STREAM'!^  YES 

MANDY  FU.JNSTREAM 
/ /UIRISRUN   JGB    (  y  y  3lv; )  y  HANDY  v  nSGEEUEL-^  (  1  y  1  )  y  TIME-5 

/  /  F"  R  G  c:  F..  :f  b  n  n  b  s  n  g  i;  n  d  x .  y  1 9  ?  s .  u  s  i--  s .  f  r  g  c  l  i  b  "  d  :f  s  f  ■■■■  s  f  i  r 

//   EXEC  U R I S  y  I--- F< G ■■■■  F^  A N D  Y  y  F  :F  F..  F-  N U M ^^^^ ;F 

//input  db 

I-  ]■  L  E  s  I  1  n  f  u  t  u  Fc  ];  s  0 1 J  G  u  J  F  u  I'  u  F^:  :f  s  ;f  3  $ 

l-l  £  A  B  E  R  :    I"  G  R  E  S  i  -  S  'I' .  J  G  F-  ?    F..  A  Y  Fi;  R  ■■■  L  A  N IJ   U  S  F"  ?    M  A  F-'  ■  -  1  0  0  y 
I..  G  C  A  T  I  G  N  ^  B  U  Z  Z  A  R  B   R  G  G  S  J  $ 

gptigns:  skips-i$ 

gk  tg  run^!^  gk 
f-'rigrity  :  be  fay 

jub   -  4  3  62  wrisrun    sent  tg  jes2. 

bg  ygu  uant  ig  run  angtfier  "hanby"    }0b''  ng 

wris  ggntrge  prggram. 
f.  n  t  e  r  f  r  0  g  f^;  a  h  i g  e  x  e  c  u  "f  f-  (  c  r  t  0  e  x  ]'  i  y  ■  •  i  i"'  g  r  1 h  f"  g  )  :  m  e  r  g  e 

^   ^:   t        ^      MERGE   RUN  STREAM   GENERATGR      t   t   t   t  ^ 

warning  •■          tg  rebuge  erg ges sing  ggstsv  aeuayb  enter  the 

ehrgest  mar-eiee  first. 

huBE   -   2)PGEEY   GR   3;MGSAIG:  2 

enter  fief  inf  g  rm  at  i  gn  egr  first  map -h'- i  ee* 
payer :  habitat 
lugatign:  tensed 

-tape-  up  i so 1 

LAB   M   FGREST  MAP#   LAYER  EGG AT I GN  BATE 


4     2  st*jge  39  habitat  tenseb  04/23/80 

is  this  the  nap-fief  ygu  want'^'  yes 

dg  ygu  want  ig  enter  any  seeegtign  urileria  pgr  map-t-ile  gne'^  ng 

enter  file  infgrmatign  pgr  seggnd  map-pile* 
layer:  f and  use 

EGG AT I GN:  tensed 
-•TAPE--^;WRISI4  (      I)    •-  MERGE 

LAB   M   FGREST  MAF--1F   LAYER  EGG  AT  I  GN  BATE 


1        2   ST.JGE  113     LANB  USE 

IS   THIS   THE   MAP--FILE   YGU   UANT?  NG 


TENSED 


03/07/8 0 


"TAPE-   UR I SOI 

LAJB   M   FGRF:ST  hAF'#   LAYER  LGuATIGN 


2  ST.  JOE  1:1.3   LAND   USE  TENSED 

IS   THi;^-:   THE   HA!""- EI  EE   YGU   WANT?  YES 

DG  YGU  WANT  TG   ENTER   ANY   SELECT  I GN   CRITERIA   EGR  MAP-EILI 
Di;   YGU   WANT    IG   WRITE   GUTPUT  EI EE   GNTG   TAPE?  NG 
DG   YGU   WANT   A   LIST    Gl-    THE  RUN  STREAM''  GK 

MERGE  RUNSTREAM 

/  /  W  R I  S  R  U  N   J  G  M    (  y  y    0  )  V  M  i;r  R  G  E  y  M  S  G 1...  E  U  E  I...  ■■■■■  (  J.  ?  J.  )  y  J  1 M  E  ■■■  '5 
/ ./  R  R  G  l:  I.  .i:  B   D  D   D  S  N  ■■■■■  G I N  l  <  x  .  Y  :I.  9  7  8  .  U  S  E  S  .  R  R  G  C  L  I B  y  D ;[  S  R  ■■■^  S I  I R 
/'  /    E  X  E  (.:   W  R  ;i:  S  V 1  ■  K  (J  G  ■■■  M  I::.  R  G E  y  E  1 1._  E N  U  M  ■■■■■■■■  1 
//INPUT   DD  >^ 

1 1... E s :  1 N  I-"'  u  r  G  N  i:  ^  w R 1  s  0 1 0  :i:  n  f-'  u  i'  r  w g  ■■■■  w  r  :i;  s  o  j.  ?  g  u  t  i- •  u  j  ■■■■  n  g  n  e  i> 
i-i  E  A  D  i;;:  r  g  n  i;;:  i  e  g  r  e  s  r  j;>  r  *  j  g  i;;:  ?  m  a  i---  ■■■■■■■■  9  ?  i ..  a  y  i;;;  i-^  - 1- 1  a  b  i  tat  $ 

GPTIGNS:  SKIPS^:::3$ 

!••!  i;-  A  D  E  R   J  W  G  :    E  0  R  E  S  J  ■■■■■■■  S  T  .  J  G  E  ?    M  A  I- '  ■■■■■■■  1  J.  3  ?    I._  A  Y  E  R  ■■■■■■■  I...  A  N  D   U  S  E  $ 
GPTIGNS J    SKI PS- 4$ 

Q u T' I"* u  r  I-I i;;: a d i;: r  :  i--  g r e s t - s  r  *  j g e  ?  i... a y e i-:: ■■■■■■  i... a n d  u s Ev  ma f-- :i.  ;i.  3 $ 

Ul\   TG  run?  GK 

prigrity:  delay 

JGB    4399   WRISRUN     SENT   TG  JES2* 

DG  YGU   WANT   TG   RUN   ANGTFIER    "MERGE"    JGB?  NG 

WRIS  CGNTRGL  PRGGRAM. 

i::  N  T  i;;;  r  r  r  g  g  r  a  m  t  g  e  x  i;;:  c  u  r  i;-  ( c  r  t  g  e  x  :i:  r  o  -  :i.  e  g  r  i  n  e  g  ) :  m  g  s  a  i  g 

t  t   t   t   ^'i^     MGSAIC  RUNSTREAM   GENERATGR     ){<>[(   ^f:   >K  >K 

enter  ei ee  inegrmatign  egr  first  map- pile* 
enter  mgde  2)pglly  gr  3) mgsaic :  2 
layers  habitat 
lgcatign:  tensed 

-tape-  wrisoi 

lab  m  egr est        mapt  layer  lgcatign  date 


4        2   ST*JGE  59   HABITAT  TENSED  04/23/80 

IS   THIS   THE   MAP -FILE   YGU  WANT?  YES 

E  N  T  E  R  r  I  -I  ;i:  n  n  :i:  n  g  e  a  c  r  g  r  ( c:  r  -  d  e  e  a  u  l  r  t  g  2 .  o  ) : 

DG  YGU   WANT   TG  ENTER  ANY   SELECT I GN  CRITERIA   EGR   MAP -FILE  GNE?  NG 

ENTER   FILE   INEGRMATIGN  PGR   SECGND  MAP-FILE* 
ENTER  MGDE   2)PGLLY   GR   3)MGSaIC:  2 

Layer:  land  use 

LGCATIGN:  TF-iJSED 


DATE 

04/23/80 
TWG'!'  NG 


E.6 


■-TAPE->KUJFi;:i:S:l.4(      D   -  MEI-a^iE 

LAB  M  FORES 7  MAP#  LAYER  LGUATIGN  DATE 


J.        2  ST.  JOE  113     LAND  USE  TENSED  0:5/07/ SO 

:iS   THIS  THE   MAF'-EILE   YOU  WANT?  NO 

■  TAPE-  WRISOl 

LAB  M  I'  n  R  i:::  s  t        m  a  w-  l  a  y  e  r  l  o  c:  a  t  ;i:  d  n  d  a  t  e 


5       2  ST ♦JOE  113  LAND  USE  TENSED  04/2 3 /SO 

IS   THIS   THE   MAP-FILE   YOU   WANT?  GK 

E  N  I E.  R   T  l-l  1 N  N  :i;  N  U   F  A  C:  T  0  R  (  C  R  -  D  E.  E  A  U  I...  I '   7'  0  2*0): 

DH   YOU   i4ANT   JO  ENTER  ANY  SELECTION  CRITERIA  FOR  MAP-FILE    iWU^!^  YES 
I"'  G  I...  Y  G  0  N   S  E  L  E  C  T .[  G  N  S   S   0  J 1 0  N  . 

E  N 1'  i:!  R  G  E  T I  ON  NUMB  E  R    (  0  R    -  E  X I T  ?    - 1   0  E  J I G  N  l._ ;[  S  T I  HO)  t    ■■  1 


options:  1 ) 

INCLUDE 

2) 

EXCLUDE 

3) 

INCLUDE 

4) 

EXCLUDE 

5) 

INCLUDE 

6) 

EXCLUDE 

7) 

INCLUDE 

8) 

EXCLUDE 

9) 

INCLUDE 

1 0  ) 

EXCLUDE 

1 1 ) 

INCLUDE 

ENTER  OPTION  NUMBER    (CR   -  EXITy    -1   OPTION  LISTING):  7 
:i  N  C  I...  U  D  E  A  R  i;-  A  S  G  R  E  A  T  I- :  R    T  i-l  AN    (  :i:  N  A  C  R  E  S  )  :  5.09 

ENTER   OPTION  NUMBER    (CR  -  EXIT?    -l   OPTION  LISTING): 

I"""  (3 1._  Y  G  0  N  S  E  L..  E  C 1 1 0  N  C  0  M  I-"'  i...  E  T  E  D  . 

DO  YOU  WANT  TO   WRITE   OUTPUT  FILE  ONTO  TAPE?  NO 
DO  YOU   WANT   TO   SPECIFY   ANY  MOSAIC  OPTIONS?  OK 

0 p T :i: 0 N s :  1 )  M :i: n i m u m  :i: n e u t  e o i... y o g n  a r e a ■■■  x  (5.0  m:r e s  d e e a u l.  1  >  ? 

2  )    MI N I M U M   0 [\  r I--' U I'   E 0 1... Y 0 N   A R E A ■  ■■  X        *  0   A C R E S   D li: F A (. i I ..  I  )  ? 

3)  MINIMUM   MAP   SLIOER  WIDTH-^Xl? 

4)  MINIMUM   GROUND   SLIOER  WIDTH:=^^X2 

ENTER   MOSAIC   OPTION   NUMBER    (CR   •-   EXIT):  1 

i:.. N r E R  M :i: n i m u m  in F^' i. J T  E O L Y 0 0 N  A R E A   (  j; N  A C 1-^ E S )  :  2*0 


i  A.'. 


ENTER  MOSAIC  OPTION  NUMBER    ( CR    -  EXIT) 

i::  N  T  E  I-;;  m  i  n  j:  m  u  m  (3  u  t  e  u  t  e  o  i._  y  g  g  n  a  i-^  i;;:  a  ( :i.  n  a  c  r  e  s  ) :  i  ♦  o 

ENTER  MOSAIC   OPTION   NUMBER    (CR  -  EXIT):  4 

ENTER  MINIMUM   GROUND   SLIOER   WIDTH    (IN   FEET):  150,0 

ENTER  MOSAIC   OPTION   NUMBER    (CR   -■  EXIl): 


E.7 


riO  YOU  WANT   A  LIST   OF   THE  RIJNSTREAii>  OK 
MOSAIC  RUNSTREAM 

/  /  w  R I  s  f<  u  N  J  u  i:<  ( y  y  0 )  v  M  0  s  A I  c  y  M  s  I...  i;:  u  i:;;  i...  ( i  v  i )  y  i"  :i:  m  e 
/  /  F  R  0  c  1. 1 B  n  i:i  i;i  s  n  g  i  n  v  x  .  y  i  9  7    u  s  f  s  *  f  r  0  c:  1...  ;i:  b  ?  i\  1  s  f  s  i-i  i-;; 

/  /  1;;:  X  E 1::  W  R 1 S  y  I- '  R  0  G  ■■■■■■■  M  0  S  A 1 C  y  I-"  1 1.  E.  N  U  M  ■■■■■■■  1 
//INPUT  DD 

F 1 1...  i;;:  s  ^  :i;  n  u  t  o  n  i;-  ■■■■■■■  w  i-;:  :i:  s  o  ;i.  ?  i  n  i"-  u  t  t  w  o  ■■■■■■  w  f<  i:  s  o  :i. ;  o  u  r  f  u  r  ■■■■■■  n  o  n  e;:  $ 
iieader  one  :  eorest^^^^st  .  joe  ?  map ^^^1:^9  ?  layer^^^^-iab  i  tat  ? 
state-:  idaho?  z0ne::::3$ 
options:  skips-3$ 

HEADER   two:    FOREST   ST  *  JOE  y    MAP-II3y    LAYER-LAND  USE? 
STATE:::  IDAHO?  Z0NE::::3$ 

options:      ski  PS::::  4$ 

POLYGON  selections: 

I N  C  I...  U  D  E  A  I-;:  E  A  S  G  R  E  A  T  E  R  J  H  A  N :::  5.09  $ 

0  u  T  I"'  u  T  I-I  E  A  D  i;:  R  t  F  0  R  E  s  T ::::  s  T  *  J  0 1;:  ?  I...  A  Y  i;;:  r  ::::  H  A  B I T  A  T  / 1...  A  N  D  u  s  i;;:  y  M  A  F  ■■■■■  1 1 3  ? 

LOCAT I ON- TENSED? 

STATE::::  IDAHO?      Z  0  N  E  ::::  3  $ 

M  (J  S  A I C   0 1""  J 1 0  N  S  :    M I N  :i;  M  U  M   I  N  F  U  J  F  O  I...  Y  G  0  N  A  F<  E  A ::::  2.0? 

M  :i:  N  :i:  m  u  m  o  u  t  f  i..i  t  f  o  i...  y  g  o  n  a  r  e  a  ::::  ;i. .  o  ? 

M I N I M U M   G R 0 U N D  S L i: U i;: R  W ;[ l\ T H :::: I '50.0 $ 

OK  TO   RUN^!^  OK 
priority:  DELAY 

JOB    4451   WRISRUN     SENT   TO  JES2. 

DO   YOU   WANT   TO   RUN   ANOTHER    "MOSAIC    JOB?  NO 

WRIS  CONTROL  PROGRAM. 

i:;:  n  j  e  r  f  r  o  g  r  a  m  j  o  e  x  i;;.  g  u  t  i;;:  ( c  r  t  o  e  x  :i:  t  ?  •- 1  f  g  r  i  i-i  f  o  ) :  f  g  r  i  d 

>{<){(){(  ){<    pgr  id  runstream  generator    >}c  >{<  >k  >!< 

enter  mode  •••  2)  polly  or  3)  mosaic:  2 
layer:  habitat 
location:  tensed 

-tape"  wrisoi 

lab  m  forest        map:||:  layer  location  date 


4       2   ST*  JOE  59  HABITAT  TENSED  ()4/23/S() 

IS   THIS   THE   MAP-FILE   YOU  WANT?  YES 

DO  YOU  WISH   TO  SELF  CI   A   SUBSET   OF   POLYGONS'!^  OK 

I"  '  {]  L  Y  G  0  N  S  E 1...  E  G  J  1 0  N  S   S  i;:  C  J 1 0  N  . 

E  N  T  E  R  0 1""  T 1 0  N  N  U  M  B  Ei;  l"^    (  G  R   -•   E  X  :i:  T  y      1   0  F  T 1 0  N  I...  ;i:  S  T'  1 N  G)  I  1 

E  N  T  E  R    "  I J  E  M  S   I  G  B  E   :i:  N  C  l._  U  D  li-  D  "    (A   S  E  M  ;i:  C:  0  L  0  N  F  0 1...  I...  0  W  I N  G   T  H  E 
LAST   k^ALUE   WILL   TERMINATE   THIS  OPTION). 
ENTER  UALUES:  2:8? 


E.8 


I-:-  (3  L.  Y  G  C)  N  S  E:  I...  E  C  ]  1 0  N   C  0  h  F  I...  E  T  £  D  ♦ 

DC)  YGU  WANT  GRID  DATA  WRIT  (EN   OUt    I)  CARDS  OR   2)  TAPE  ^i^  2 
0 U T I"' U T  r- 1 1... E   I  :l.    (  G R I D    "  D  "  y    "E"  ?   AN D    "  F  "   C:  A R D S  )  : 

E  N  7'  E  R   T  A  F  E  U  0  L   S  E  R  t    W  R 1 S  2  2 

FILE  ON  URIS22   TG   WRITE   TG :  1 

D  S  N  F  G  R    1 1 -I  A  7    I-  i:  l._  E  t    T  E  N  S  E  D  J-l  A  B I  I '  A  I" .  D  E  F  .  C  A  R  D  S 

.HI 7- 1"' LJ r  !-■  ;i: i. e  1 3  ( f g i... y g g n  i._ a b i;;: i.„ s ) : 

EN7  ER    I  APE   "v^GL^SER:  WRIS22 
FILE  GN  WRIS22  TG  WRITE   JQt  2 
DSN  PGR   THAT  FILE:    TENSED ♦ HAB I  TAT . LABELS 
DG  YGU  WANT  A  LIST   GF   THE  RUN STREAM?  YES 

PGR ID  RUNSTREAM 

//\4R  1 S R U N   J (3 B    (  y  y  5 0  y  9 9 9 9  )  v  F G R 1 D  y  M S G E E K> E E ■■■■^  CI.  y  J.  )  y  T I M E ■■■■■■■  ^ 
/  /  F  R  0  C  L..  I B  D  D   D  S  N G 1 N  D  X  *  Y 1 9  7  8  *  U  S  F  S  .  I""  R  G  C:  l._  1 B  y  D I S  F  ■■■■■■■  S  H  R 

/  /  EXEC  w  R  :i:  s  y  i---  r  g    i  •'  g  r  i  d  v 

//  JF  G  u  T  #  :i.  w  I-;;  i  s  2  2  y  ;i:  i...  i;;;  w- 1  1  y  n  a  n  e  f- 1  ■■■■■■■■ '  t  e.  n  s  e  d  .  i-i  a  b  i  r  a  i  ■ .  d  i;:  f  .  c  a  r  d 

/  /    r  F  G  U  r  1^  2"M  R 1 S  2  2  y  F 1 1...  E.  W-  2   2  y  N  A  M  E.  1 2  ---^ '  T  E  N  G  E.  D  J7  A  B 1 7"  A  F  ^  I...  A  B  E.  I...  S  ' 
//INPUT   DD  >!< 

files:  input-:wrisoi$ 

17  FADE  I-;: :  f'  g  r  e  s  t"  s  7'  *  J  G  i;;:  ?  i...  a  y  e  r  h  a  b  :i:  t  a  7'  ?  ma  f  ■■■■■■■  9  $ 

(7PTIGNS:  SKIPS^^:3$ 
PGLYGGN  SELECriGNS: 
INCLUDE  ITEMS::^2:B$ 

ok  tg  run?  gk 
prigrity:  delay 

jgb   -  4472  wrisrun    sent  tg  jes2* 

dg  ygu  want  tg  run  another  "pgrid"  jgb?  ng 

wris  cgntrgl  prggram. 

enter  prggram  tg  execute  (cr  tg  exit?  -i  fgr  infg);  pglly 

>{<  :^  >k  ){<       pglly  runstream  generatgr  ;{< 

this  exec  fil7:::  requires  a  member  tg  be  stgred  in 
g i n  d  x  *  y  j.  9  7  8  .  f  0  e  e  y  d  k  s  .    7"  17 :[  s  f 1 1...  e  m  u  s  7  c  g  n  t  a i n  :  i  )  c  (  i  n  7'  r  g  e 
F LI  I N  r  s  y  2 )  i: G I-i: R i;;: c t  i  o n s  s i;:: c t  i  o lu  an d  3)  i._  a b e e s  s i;-  c  r  :i;  g n  . 
(changes  can  be  made  by  the  #xedit  exec  file*) 

are  ygu  wgrking  with  (i)  b i pr in  data  gr  (2)  handy  data?  i 
layer:  habitat 
lgcatign:  tensed 

••  :APE->}<WRISI2(      I)    •••   B I  PR  IN 

LAB  M  FGREST  MAP#   LAYER  LGCATIGN 


TENSED 


•-TAPE-  UIRISOI. 

LAB   M   FOREST  MAP#   LAYEF<;  Li) CATION  HA  I  E 

3  1  ST.  JOE  1^9  HABITAT  TENSEB  04/23/80 
IS   THIS   THE   MAP-EILE   YOU   UANT'^  YES 

DO   YOU   WANT   TO   UPDATE   THE   HEADER  RECORD?  NO 

t   t   t   YOUR   MAP-FILE   WILL   BE   WRITTEN   TO   ){<WRISI5y    LABEL  I. 

OPTIONS   SECTION  ^ 

1 )  s  w  A  F  X  Y  y  2)  c  H  li- 1:  i\  I  I 0 1- 1;-  s  ( c  R  I:-  X  :i:  r ) : 

E  N I  E  R   M  i;:  M  B  I!-  R   N  A  M  E    I N   G  I  N  D  X  .  Y  I  9  7  8  *  E  0 1 ..  I...  Y  B  l\  S  I    H  T  i;-  N  S  [■  D 
DO   YOU   WANT   A   LIS!    OF   THE   RUN  STREAM'^  NO 
OK   TO   RUN'f'  OK 
PRIORITY  I  BELAY 

JOB   -   4  4  9::^   WRISRUN      SENF    fO  ..IES2. 

DO   YOU   WAN!    10   RUN   ANOFilER    "POLLY"    JOB  NO 

WRIS   CONTROL  PROORArU 

ENTER   PROORAM   TO   EXECUTE    (CR   TO   EXIT?    -I   FOR   INFO):  TONIC 

>^   *   *   )K   :^      TONIC   RUNSTREAM   OENERA  l  OR      )i<   )K  ;^ 

MODE    -   2) POLLY   OR   3) MOSAIC:  2 
I...AYER:  HABITAT 
LOCATION :  TENSEB 

■-TAPE-*WRISi::i  (      I)    •-  POLLY 

1...  ABM   E  0  R  E  S  J  h  A  E -W-   I...  A  Y  E  R  I...  0  C  A  I  1  0  N  B  A  T  i;- 

1        2   S  T  .  J  0  E  '5  9        I  I A  B  I  T  A  I  1 1:;:  N  S  [•  B  0  5  /  0  7  /  0  0 

IS   THIS   THE   MAP-FILE   YOU   WANT-'  NO 

■-TAPE-  WRISOI 

LAB   M   FOREST  MAP  11^   LAYER  LOCATION  BATE 

4  2  ST ♦ JOE  59  HABITAT  TENSEB  04/23/80 
IS   THIS   THE   MAP-FILE   YOU   WANT'i'  YES 

DO   YOU   WANT   TO   WRITE   ONTO   TAPE'I^  NO 

E N T i;-  R  T 0 N  :i: c  o E  J 1 0 N  N u M B i;: R  ( c I-;: E X  :i:  j  y  ■- ;i.  o e  j  i  o n  l i s  j i  ug)  :  - 1 

options:    I)  HE ABFR  UPBATES 

2)  POLYOON  SELECTIONS 

3)  LABEL  COMBINATIONS 

4)  NEW  LABELS 

5)  NEW  LABELS   BY  LOCATION 

6)  NEW   LABEL  LOCATIONS 

7)  STORE  ACREAOES 


E.IO 


i;;: n t e. r  t o n i  c:  o f t  i  u n  mm b e r  ( c r  ■■  i •  x :i:  j » - :(  i:i i  •  i  ioii  i  t  ^ )  1 1  n g  )  i  3 

EHJER   LABEL   COHB I  NAT  I GNS :      (80   CHARACIERS   OR   LESS   PER   EINEv    A   DUELAR  SIGN 
FOLLOWING   THE  LAST   UALUE   WILL   TERMINATE   THIS  OPTION), 
ENTER  UALUES:    S00:^:^5 1 0  y  520  y  :;^30$ 

ENTER   TONIC   OPTION   NUMBER  (  CR--EX I T  y  ■  •  1   OPTION  LISTING):  4 

ENTER   NEW   LABELS?      (SO   CHARACTERS   OR   LESS   PER   LINEy    A   BOLLAR  SIGN 

FOLLOWING   THE   LAST   UALUE   WILL   TERMINATE   THIS  OPTION), 

i;:  N  T  i;;:  r    a  i...  u  i:  s  :  2  y  r  ■  u  t'  0  3  y  s  s  0  $ 

ENTER   TONIC   OPTION   NUMBER  (  CR-  EX I T  y  •- 1   OPTION   LISTING):  5 

ENTER   NEW  LABELS   BY  LOCATION:      (SO   CHARACTERS   OR   LESS   PER   LINEy    A   BOLLAR  SiGf 
FOLLOWING  THE  LAST  UALUE  WILL    lERMINATE  THIS  OPTION), 
ENTER  values:    999   1487   I4I7y    990  339  II3S$ 

ENTER   TONIC   OPTION  NUMBER  (  CR-EX  I T  y  •■  I   OPTION  LISTING):  6 

ENTER   NEW  LABEL   LOCATIONS:      (SO   CHARACTERS   OR   LESS   PER   LINEy    A   BOLLAR  SIGN 

FOLLOWING   THE   LAST   UALUE   WILL   TERMINATE   THIS  OPTION), 
E  N  T  E  R  V  A  I...  U  i;-  S  :    4  y  1 4  S  0  y  1 4 1 0  y    ;l.  J.  y  3  4  0  y  I  ;l.  4  0  $ 

E  N I E  R  r  0  N  :i;  c  o  r-'  j  i  o  n  n  u  m  b  i;::  r  ( c  r  e  x  :i;  t  y  ■■  ■  i  o  r-'  r  i  o  n  i...  :i;  s  j  i  n  ) : 

DO  YOU   WANT   A  LIST  OF   THE   RUNSTREAM?  OK 
TONIC  RUNSTREAM 

/  /  w  R  :i:  s  R  u  N  J  OB  ( y  y  4  5 )  y  r  o  n  :i:  c:  ?  m  s  g  e  e  u  i;:  l  ■■■■■■■■  ( i  y  i )  y  r  ;i:  m  i;;:  '5 

/  /  P  R  0  C  I...  :i;  B   B  B   B  S  N   G 1  N  B  X  ,  Y  :L  9  7  S  ,  U  S I  ■  S  ,  I"-'  I^C  0  C  E  1 B  y  B  J:  S  P  ■■■■-^  S I  I R 

//  EXE c  w R ;i:  s  y  i ■•  r o i ■} 1  o n  i  c  ^  r-  :i:  i. . e n u m i 

//INPUT  DD  * 

1 1...  i;;;  s :  ;i;  n  !••■  u  1  ■  ■■■■■■■  w  :i:  s  o  i  o  o  i.j  t  e  u  t  n  o  n  i;-  $ 

l-l  E  A  B  E  R  t    E  0  R   S  T   S  I ' ,  ...i  0 1;;:  0    M  A  E   5  9  y    1...  A  Y  i;-  R   11 A  B I  T  A  T  i|> 

options:  skips:^:^3$ 

H  E  A  B  E  R  U  P  n  A  T  E  S  ^    E  0  R  E  S  T  ■■■■■■■■  S  J  ,  J  0 1;-  ?    M  A  I- '  5  9  0    1...  A  Y  E  R  l-l  A  B  :i:  I A  T  ? 
L0CATI0N:^::TENSED$ 

L.  A  B  E  I...  C  0  M  B I N  A  T 1 0  N  B  t    500  5 1 0  y  5  2  0  y  5  3  0  $ 
NEW  labels:  2yP0Ty3yS80$ 

NEW   LABELS   BY   LOCATION:    999   1487   141 7 y    998   339  1138$ 

N  i;;;  w  i...  a  b  e  l  i...  o  c  a  t  i  o  n  s  :  4  y  ;i.  4  8  0  y  ;i.  4 1 0  ?  1 1  y  3  4  0  y  :i.  :i.  4  0  $ 

ok  to  run?  ok 
priority:  delay 

job  -     4315  wrisrun    sent  to  jes2, 

do  you  want  to  run  ano  fher  "tonic"  job^i^  no 

wris  control  program, 

enter  program  to  execute  (cr  to  exit?  -i  for  info):  xchg 

){<){<){<){<  :{(    xchg  runstream  generator    *  )j<  ){:  >k  >k 

enter  mobe  •-  2)  polly  or  3)  mosaic:  2 

LAYER :  HABITAT 
LOCATION :  TENSEB 


E.ll 


-  lAF-'E  ••■•>KUR  I  S  llvM 
LAB  M  FGRF-ST 


;l.  )    •■■  PGI..LY 
hf)F\\  LmYEJ'< 


I..GCA  r  :i:  gn 


ijfvn;: 


:l.        2   ST»JGE  59  HABITAT 

IS   THIS   THE   MAP  - FILE   YGU  UANT'i^ 


NG 


TENSED 


()5/()7/S() 


-TAPE"  WRISOI 
LAB  M  EGREST 


MAP#  LAYER 


EGG AT  I GN 


DATE 


4 


2  ST*JGE 


HABITAT 


TENSED 


04/23/80 


IS   THIS   THE   MAP-FILE   YGG   WANT'-^  YES 

GPTIGNS:    I )  TRIM 

2 )  NGTRIM 

3)  LABELS 

4)  NGLABELS 

i:  N  T  E  R   G  f  T I G  N   N  U  M  B  i;:  R    (  C  R   J  G   I  •  X  1  I  )  : 

DO   YGU   WISH   TG   SELECT   A   SUBSE  1    GF   PGLYGGNS'i^  YES 
I"'  0 1_  Y  G  (J  N  S  E  I...  i;-  G  T I G  N  S   S  i;:  C  J 1 G  N  ♦ 

L N J E R  G r- T ;i; g n  n u m b i;;; r  ( c r  ■■■  e x :i: t  v   - 1  g i ■■  t' ;i; g n  i... :i: s t i ng)  i  i. 

ENTER    "ITEMS   TG   BE    INCLUDED"    (A   SEMICGLGN   FGLLGWING  THE 
LAST   UALUE   WILL   TERMINATE   THIS  GPTIGN)* 
ENTER   UALUES:  2:8? 

r-'  0 1.„  Y  G  G  N  s  E  I...  i;-  c  J  :i:  g  n  c  g  m  i--  l  i;:  j  e  d  . 

DG   YGU   WANT   XCHG   DATA   WRITTEN   GN:    I)  CARDS   GR   2)TAPE'^  I 
DG   YGU   WANT   A  LIST   GF   71  IE   RUN  STREAM'!'  GK 

XCHG  RUNSTREAM 

/  /  W  R  1  S  R  U  N   J  G  B    (  y  y  3  U  ^-  9  9  9  9  )  V  X  C  H  G  f  M  S  G  I...  i;-  U   I...  ■■■■■  (  ;l.  ■>  I  )  v  J  I  M  E  "5 

/  /  F  R  G  c;  L_  ;i:  b  d  d  d  s  n  ■■■■■  g  i  n  d  x  »  y  :i.  9  7  8  ♦  u  s  r-  s » i---  r;:  g  c  l  :i;  b  y  d  i  s  i"-  s  i-i  r 

//  EXEC  WRISyPRGG^^::XCHG 
//FTIIFOOI  DD  SYSGUT-B 
//INPUT   DD  % 

files:  input-wrisoi$ 

h  e  a  d  e  r  :  f  g  r  e.  s  \  ■■■■■■■  s  t  .  j  g  e  ?  l  a  y  e  r  -  h  a  b  ;i:  t  a  j  ?  m  a  r  ■■■■■■  u  9  $ 

i-i  £  a  d  e  r  u  i"'  d  a  t  e  s  :  !••  g 1.;  e  s  t  s  t  *  j  g  i;-  ?  i...  a  y  i;:  r  ■■■■■  i -i  a  b 1  j  a  1  j  m  a  i-'  5  9  ? 

lgcat i gn-tensed$ 

gptigns :  si\ips-3$ 

pglyggn  selectigns: 

include  items:^<;>:8$ 

uk  tg  run?  gk 
prigrity :  delay 

jgb       4:-^ 3 9  wrisrun    sent  ig  jes2, 


DO   YGU   WANT   7G   RI.IN  ANGTIII-R 


XCHG 


JfjB  ? 


NG 


E.12 


WRIS   CUNT  Fall...  F'RnGi-<Ah, 


F I  ^  T'  i;::  i-^  i--'  r  g  g  r  h  m  j  g  e:  x  [■  g  g  t  i;;;  ( c  r  ■  i  ■  g  i;-  x  :\  t  ?  ••••  i  r  g  r  i  n  f  g  ) : 

SrjUEI...nG  RERL.riCED  ON  l.ise:ro4 
H  I"  J  0  E.  A  ( ;  I"   R  E  R  E  M  G  E 1 1   G  ri   Li  S  E.  R  0  1 

FND   OF   tXUIRIS  SESSION. 


E.13 


Ill 


APPENDIX  F.  RID*POLY  SAMPLE  RUNS 


The  sample  runs  contained  in  this  appendix  were  produced  from  the  job  streams  hsted  in  previous  chapters  of  this 
manual.  The  job  stream  decks  are  contained  on  the  distribution  tape  (see  appendix  D). 
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<— CvJOOf^OCMU^OrOt—  CMOLAln-3■C^J^C^M'— 1—  CMOt~O^OOOu>JCDooC>CMCMCMJ'— VOOOOC^OCC^ 

CMlX^CMu'^^-lAC^JJ^Ol^or^OP--CM'-CMcoooJ■CMlACMlACMlr^I— l^lOL'^c^Lr^c>L'^o^vcc:^^^ 
r-^-'-^--T-r~-r-!^T-c^'-C3^'-c^'-oO'-^-'-f^r-^~r-t^T-^~t-r~-'-^^or^or^o^^or^or^o^o^ 

J-.-J-i-J^T-J-^Cr'--d-'-Zf'-J-r-J-i-^r-^.-J-T-^r-J-r-J-r-J3-T-J'-jT-^,-J-T-jT-Jr-J-r-J-r-J-T- 


^      0<^■3■C^'-CJ^'—  0^\O^O^O^^C^JCO'—  L'^O-r-vC0DO-3-^'-CMCV^-3-aDvC'-v000r~~OOroCMvC-d-^ 

1—      in-— roCMC>'—  >—  CMCM-a-"—  rocOCM'OODroC>r^OO!V!Ln'— J•^-CMC>^^OOC^C^CMC>C■^vCr^^COC>C^ 

O      rvJCMt—  !^(^0<~0'—  O-d-'— rOT-u'^f^J-C>J-u'^^<—  CMCM-—  fOOroinON^O^OOi^CCMCM-—  J^COOCD^ 

LncMLncMl^c\J''J^CM^-o^~~o^^ocrcMC^CMvocMLncMLi^cML-^CML'^'— j-c>Lnc>L'>c>oc>voc> 
T-  r^r-r^,-r^--^^r-c>'-c^'-o^r-oor-r^I-p--T-^-'-r^r-^~-'-r--r-^^0(^or-~ot^o^-ol^Ol~--Ol^o^-~o^-o 


LncO'-LnJaDr^^o^^ja^^^ocrcMO^-o^o[^Ln^oc^CM^~ocJ■^~c>OL'^ooocW'-l^^JTCMu'^o^ 
ir>c>[^c^crr^LriaNCMvoorovoj-ON^oc>CMr^r-rou'^c>r~c>>-^r^coovcor--\0'— vcc\i<»u^ 

T— (\i(>vOf^OCML'^0-d''—  CMCvJJ'l'>j3-C0^C!~Oi— 1—  CMCI^■^^^C^Cti^-3■r^^oc>^OT^ 

CMLr^CM^'-LACMLnQ^^o^^OP--CMT-cMC>CML^^cML^^CMLr^cM■-'^'-JOu'^c7^u^c^Lr^c^O(:^oc^'^C(>^o« 


Jr-ja-.-J-'--:?-'-^'—  J-'-J-'-J'-^'—  J-'-J-'-^'-^T-^.—  ^i-^'-J-'-, 


CO  (- 

Q  < 
cc  I— 
<  - 

I  < 


ooovOLTNcoLnr--'— f^i— ltn'— ocTN-d'f^or^ooocM'— oo-r-c>CMoofou'>:v'0^~j^~ca'Oi^^ 
Lnc^L'^t^CNC^tn'— jocNvooDCMoDOcor^CNoocNr^CM^'— ^'— ccc^'CMJ^CMr^-^. 

CM-— '—  roCNC>Mi—  0-:rOi^'— CV^L'^C>.J■u^^OCMCM'—  t^C-3"L'^.  O'L'^^C-::^^ 

Lr^CMLncMJ■'-lAC^J^-OI^o^^OJCMC>CMvocMLncMlr^cML'^CMa^'-a'^OL^\c^u'^o^\C(J^oc>oc^oc^ 

r^-— r^i— r^i— ^~'— CJN'— c^'— c^'— CS5'— i^i— i^"— i^i— f^T-f^.—  f^T-r^Oi^O!^or--or^o^-or^or^or--or^or~^ 

'-^'-J^'-J3-'-^'-^'-J-'-J-'-J'-J-'-^'-J-'-J-'-^'-^'-C-'-J'-C-'-J-'--3-'--d-'-J'-j'-^'--3-'--3^ 

00\OCMvOOC^roOrOC>r^J-^Oii^tr)CMinOC>OcOO'—  f^L'>OD'— ininoOC^raCMOON'— CMJ-CTnlH 
OC\JL!^C>C0'—  (~OC>0^'—  <^r^crOoOOOU^CO-d"CMLn'—  L'^'—  u'^ONC^L^CMvC-lTONrO'— ^ 
OCMCMOCMJ"OC\iCO-S"'—  C\JCMCO-S"cacrCMrO'— CMCM'-^^C7^C^r^Lr^J^r^I^C>^'— CMt^"—  lTNC^ 

ClACMLncMLn(^JL'^c^^or^o^^Ol^cMO^CMu'^CML^\rMLncM■J^'--3■OL'^c^u'^c^L'^c>^cc>o 

■  or^'— r^'— r^'— '^OON'— c^i— C3NO00'— r^'-r^'— F^T— '^'— '^'— r^"— ^^oi^or^or^or^or^cr^o^~or^or~-c^-or^or-- 


■  \C     o  ^  \C 


QLjJLi_Ij_Li_Li_U_LuU_Li_Li_Li. 


1 


F.37 


fOC\JVOrol^crvOOOOi^rOT— J-Ot^'— r^C\JC><^rOJ^a^J•C>^000^0^00vO0^O00^o^O^^^^ 

r^Lf^<X)LA(^JC^J-d"crc\JC\JC>I^ooco^ocvOLf^^oo^<x:)C\J^— Lr^foo^c^c\J'— p--r^zr 

-d"C\Joo^fv:>03(\JO>'—  OONLnaN(r)OOC\ja30r^<C^f^vOL;^Lr\ro^C\JJ-OroroiiA'—  ODi—  Ln 

coo^oocoooooo^<»coc^l^o^r^oo^^a3^~--coI^t^^-^^r^[^r^l^r^^-^^l^r^vovovOlA^ 

oi^or^or^or^oi^or-~or^or^oi^oi^ot^or^oi^or^or--o(^ot^or^oi^or~o(^or^oi^ot^oi^ooooooooooc»o« 


jJ^J-T-J-i-J-i-Z^T-ja-T-J-r-J-T-J-r-jT-J-r-J-i-JJi-J-T-J-r-J-i-J-i-ja-'-J-'-J-i-J-'-J-'-J-T-ja-'-^ 


^O^^1-^0J■^~Or-^O^OLnOLnT-l~^O00O0^v0O^Ov0C^J00C\JlncrlP--^00  00lAC^^^^'-1-^o00CMln0^^ 

roc\Jrof^T-ovoco^^or^ooT-orolr^c^coT-c\JJ3■o^-oocoo^c^^oooc\J(^JJ-ovDvoI^r^r^ 

1— J-roroiArocO'—  C^O"—  O^-d■O^o^0O'— ^^C^r^<X3^0^Lr^J-LnfOzr1— JOvOi—  o^'— lA^-—  O"—  o^-oc^ 

oooocooooD<x)oDcoooapc>i^oor^oor^cor^r--(^r^r^r~-r^r^r^r^t^r^r^r^MDvoir\^OLnv^ 

i^or^or^or^oi^oi^oi^ot^oi^or^or^oi^oi^o(^or--or~-or^or~oi^or^or^or^or-or~or~-or^ooooooooooooo 


r-J^-T-J-r-Jt.-J-r-J-.-J-.-JTr-J-T-J-T-J-.-jrfT-J-i-^^Cr'-cr'-^'-Crr-Jjr-J-.-ja-r-J-T-Crr-cr'-J-'^ 


roolno^--z^oo^oOlAcvJ■ooror^ool^coc^-d■r^Lnl^^Lnr^^^<OJ■o^J■r-voooo\oc:^vooc\J 

r^rOr-OC\JC\J\0'—  (^CvJCVJinrOCNivO^"—  ONf^'—  Ch-CT'—  l^in"—  ON-a-rOOr^vOf^O"— 
J■C\JJ■^rooOCMC^t-OOvOO^J■OOC\JOOOI^C^^O^^^OLALr^JJ■CMJ■'— roC^vO'-00'-ir>C\Jr-Lr^ 

a^oD(»oooccococoooc^oo<»I^co^-oor^oor^r^^-r^f^r^I^^^F^^^^^I^^~^^vOl^\^Olr^^L^ 

of^or^or^or^oi^Of^or^O(^oi^or--of^oi^or-~oi^or--or~-oi^oi^or^or^or^or^oi^or--o>-cooooooooocoooo 


c^coroT-^<X3iALnT-oi^ONvoo^voo3oooN^oo^'— ini— voroo^-d■l^\Lnc\JMDC\JC^(>r^oc\Jv^ 
T-lnc^^-~o^'-^o^^oo-3■L^^o^-c\JJ■l^coocML^^^coooc^JLr^voooo(^JJ■c^lvoc\Jro'-ooa^ 

1— -:t(NJrojrooDr-ONOOONinONrOCO'—  r^OI^OOvO^vOLALAroJ-'— J-OvOr-ON'— r^vO'—  '-C^ 

a^co<X)ooo^ooooo^ooooc^l'^co^-oor^o^i^oo^^r^l^^^^^^^^-^^r~-^~-I^r^^ovOLAvOlA^Lnv^ 

r-~0(^or~-or--or-oi^oi^of^or-or^oi^oh-oi^o(^or--oi^or^or^or^or--oi^or~-oi^or--or^oi^o 


r-cr'--:rT-j-t-^i-j3-'-j-'-j-'-j-'-cr'-cr'-J-T-^,-j-t-j-r-j+T-j-.-j-i-j^^^^crT-cr'-jr-^r-j-,-^ 


©(XJi— r^J-Ot^CNJiAOror^roJ-OOvOi—  ^^00^'0<^'— ^(^r-vD^Or-CNOOt^OUOCMir\J-C^ 
liAT-^ro^000<^J0^r-OO^D0^J■00C\J<X)'—  ^~C^VOF^^^LAJ■L^^C^J-d■l—  MC^^r-0>'—  li^vCt^ 

o^«5oocoooco<»coooc^cooo^-co^^o^f^co^-l^I^^-!^(^^-^-r^^^^^r^r--\ovovoL^ 

or--or^or^ot^or--oi^oi^or^or^or^or^ot^or^oi^oi^ot^or^or^Qr^or~~or^oi^or^or^or-~ocoooooc300ooooo 


Jjr-J-r-J-T-J^T-crr-J3-r-Jd-r-J3-,-J3-r-J-,-Cri-J-i-J-T-J-l-J---Jr-^^J?r-JJr-^l-J-,-J-r-J3-^ 


ooo<^^j-<^iACMi— Li^^^^a^^ooc^JOf^O-d■CMlr)CMo^roo^-d"(7^L^^(>vor-<x)^oc^ 
r^u^f^o^f^1-JfOJ■o^^^ocMC\JzrlnoorooJ^--<X)OO^orv^r^\oo^-^crc\JJ■coL^\oc^ 
oJ■c\Jr^J■roo^(^JO\ooo^Lr^o^ro(»c\lo^ol^<»vor^vOl^^LArv-)J-(^JJ■o^or^LnT-^ 
cooococoo^o^cooD<x3o^c^^^oo^^oor^co^^a3^-(^l^l^^^r--^^^^I^l^r^r~f^vo^ 

t^o^~or^o^^o^-o^-o[^o^^of^o^-o^-o(^o^-ol^o^-op~o^^o^^Ol^Ol^or^O(^o^^OI^OI^or^oooocooooocoo 


r-J-i-JJi-JT'-J-T-J-r-J^r-Zff-^T-J-T-J-r-^.-JTT-J-T-J-r-J^.-J-.-Zr'-J-'-^t-ja-T-^r-^r-^r-zr'^ 


C^J^O^I^(\JI^(>t^l^^'-OJ■J■r-J■T-^0'-vOOCOOJOOvOOOCvJO^CO'-0^--d■lnO^OOlr^'-T^ 
ii^r-J-rv^rOLnC\JC0r-OO'—  ONJ-00r\J00t—  r--O^r~-0^^^OLr\CfLf^C^JJ■'—  roc^^'—  0^'—  Ln^0r-0« 

oocococ»o^oo(»coo^o^ooo^r-oD^^oot^oo^^^-r^^^^^^^^~-^^;^^^^^^-r^^vovOL'^^OLr^\Ol^ 

or^or^or^oi^or>-or^or--or-~or^of^or^or^oi^or^oi^or^o^-or^or^Of^oi^or^or^oi--or--oooo« 


Zt--J^T-J-r-J-,-ZTi-^<-J^r-^t-J-r-^^J-l-JJ,-j3-,-Ztl-J-i-^r-zri-^'-J-r-Jl-J-.-J-r-J3-r-JJ 


U_LL.U-Li_LuLuLi_LuLuLj_U_Li_Li_U_Li_Li_Li_LuLj_Li_L_Li_Li_Lj_Li_U.Li_Li.LuLi_L^ 


F.38 


l:^oO'-'-^OJl^l^^^O'-r--J■ooo-d•-d■r^r^c^Ml^\oc\JM^(^LAO'-c^<X)C^^oroow 
oor-ror^ir\Lni— c^coo^I^u^roc^'— c>vor-c\jf^ONC\joir\c\joovoj-roavtAvoj^cor^vor^ 
lAfo^-l^JOcrooofO(>^~-J-o^Ln'-'OJ•^or~LnJ-J^vocr^-^ocoo^c\J^ocMJ■voo^oo^^^Lr^ 

ooooooooooooocoocoooooooooooooocooooo<x)ooooo30i^or^or^oi^or^oi^ocoocoooooooooooooocooooooo 


ooor-(^l^vlJ■o^J■'-co^'-^^I^cv^roLnr^c^J■o^Of^J■'--d■cr^oJd-LAO^ooo'— oino^i^ 
<Nj-i^c\jr^'— ^■f^'-croooocDJ"r^-d-<^ccoo<^'vC^<X3cO'— <x)oolaoc\ji^c>c\joonconool^ 
fo-— c\JO(^JO^^f^o^^^or~--d■OlArool^^^^cotr^Ln^^^oooc^JC\JJ■c^t^^o1— \cor~-i— 
foi— c\J'-c\JO-d■or^OL^^Olr^'-l:^r-Lf^'-L^^1-Lr^c\Jlnc\JlAC\Jl^\^ocv^O'— jjc>j-r^ 

<coaooaDOoooooooooooooooc»oooocoocoocooooo<ooooor--or^or-or^or~-or^oooooooooooooooooDOoooooo 


T-^r-JJr-cT'-J-'-J-r-J-'-Jr-^T-J-r-J-r-J-T-J-.-J-T-J-r-J-^JTr-J-r-ja-r-JjT-J-r-cr'-^T-J 


iAONJ-ONJ-'-OOr^OOOvor^CMO^rO^Of^rOi-^r--i-Cvjr^OOOOOO'— lA^-00^^^-\00^-3■rOLnJ^OC^ 

oorofoj'Wt^ON'— o^OJ■Lno^^ococ^^o\oovooo(>r-cvc\Jrol^^li^^l^fO'— oov^ 
^-r^r-cMOC\]C^J■ot^Olnoln<-LnT-lnr-tr^T-u^col^^<\JLAOoror»^c\JrooJ•coLn^^Lr^^ 

0000<»OOOC>a30COOaDOOOOOOOCOOOOOCOOa30(X30000000COOf^Ot^OI^OI^Or--0000<X)OCOOOOOaDO« 


Jr-ZfT-J-T-J-T-J-T-crT-J3-T-J-^J-l-^r-J-,-J-,-J-,-JTT-J-r-J-T-J-l-J-t-J-l-J-l-J-l-jT-J-r-J3-r-J^ 


cooor-oo^r-oo(^OJ>Ol^\copo^-LnlAvoc^oocoJ■o^c^oovO'-o<^!^<oc\J^--o^o■^■coo^ 
c\JO^~-l^\MDooc^^^^o^J3•o^^oLnoOf^vooO'-Ln'— vo^f^c^ococMr-t-or^r--c:^oor^cor^ 

roiAC>OC\lOr^C>J-|^r-|^j-OirNCMvOLr\MD00LniAJ-^rol~--fv:i>—  C^Jro^orOT-\CC^^^ 

foi— c\jr-rvjoroc>:d'OJ-OLA'-LnT-ir\'-ii^r-Lnc\jLX>c\jLnajLnrororv-)T-j-c>j-v^ 

oooooo<»oooc>oooooooooooocoooooooocooooooooooooooi^or^or--or^or--or--ooooooooooooocoocooooo« 


i-j3-T-j-r-cr'--d-'--3-'-J-'--d-r-cr'--d-'-J-'-J-'--d-'-j'--d-'-cr'--3-r-^r-jT-a-T-j-T-cr'-j'-j'-^ 


1— oooo^o^Lnzrc^(^c^or^<x)c^c^^r)C\J^oo^I~--c\J'— chc\jrooovoovoc\jO'— '^c^^^^o^^oo 

oooo<X)Ocooooococooo«oooo(X)Oooooooooocoocooooocoor--or-or--cr^O(^or^ocoococoooooo<»ooooooo« 


a-i-Jd-r-J-r-J-T-J^r-cr'-J-i-J-T-J-r-J-r-J-r-^,-ZjT-J-r-^r-^i-J-^J-r-zr'-J'-:3-T-J-'-J'-J'-J 


O^Or^r-roO^Olr\r-J-o0^^lr^T-I-J■OOC^^O^O^J■LX^O'-vOOJOO^crJ■r^C^JCMa^JO^LncOLAvO^--0^lna^O 

Lr>T— o^vocoL'^r^ocoroJ^r^^~Lr^^--T-ocoo^(^JaDvOli*^Ol^o^^crc^f^'— f^o^c\JOC^^^^~ 

rOLTiONOCMOvOOirNJ-'—  r^J-0NLPi0J\OLr>\0r^lAJJ-\O-d-r^rO00(\J(\Jroroj\COI^C^ 
rOi—  C\Jr-CMO(^OcrO^OLAOLr\'—  Ln-—  iTv"—  LnCVJinCNJiACMLnCVlr^f-Oi— JCNJ-(^ii^l^^ 

coooooooocooooooooooocoocooc»offlocooooocooo3ocooi^or--o(~--or--oi^or^o<»ocooooo«oa)Ooooc^ 


»-JTT-^t-^.-J-.-JjT-J^i-J-r-a->-crr-zrr-J3-T-J3-,-J-r-J,-J-^JTT-jT-J-,-jT-JTr-J*^Jr-J-,-J3-^^r- 


coo(^J^^O[^c>f^oo<»^ooc^oc\J^-lALn^O'-vor--J3■o^L^^^lnJ■o^^^O'-o^ovoJ•c\Jvo:^ 
r^roT— c^JOl^o^^~~<-oco^--r-^^Ln'— Lr^^o^^or^cOli^LnJ■vofo<x)C^CM-3•c^OJ^o.—  \^ 

<— fOi— C\Jr-i—  0^-d■O^^OLAOu'^'—  lP\i— iTN'—  lAt—  Ln0jLn00ii>C\jr^roCM<~O'— zrCA 

o<oocooooo^(X30coocoocoooooooooooo^oo^oo^ocooooooDo^^or^or^or^o^^o^^ocoococcooooooooooooooco 


^--J?T-J-r-J-r-J-r-JJr-Cfr-Cr'-Crr-J3-i-J-i-J^r-J-T-crr-J-^jr-.-J---J-.-J-r-J3-^Crr-J-'--a-'-::^ 


lj-I^Ll-U-Lj-Ll.U-Lj_U_Li.LuU-I^U_|j-Li-Lj-lj-Ll-Lj-Ll_U.Ll-LL.Li-Lj_Ll-U_L^ 


F.39 


ovoc^li^coJ■oo^o^<^c\J^~~lAC^lnooo^J3•^oofoc>CMT-^oJ■Lf^^^r-o^oroJ■J■^o^<^ 
-d■ooJ■lr^o^oo^^L^^o^o^u^oOln^^^r-o^-c^JC\JJ■covorr^oc^'-J■^ooLnL^^c^O'-LnLnc\JlAr^ra 
vot^lAJ■ro^^a^covO'-^^o^^voo^oocooa^roc^L^^o^^oc^r-(\Jr-J-c\J^foco^oo^ooJ■L^ 
J■c^JJ■c^JJ■c^JJ■c\JJ•roJ•coJ■o^J■^oJ■JJ-J3■-d■J•L^^J■Lr^J■lnli^L^^li^LnliA 

OOOOaDOOOOOOOCOOOOOCOOOOOOOOOOOaDOOOOC00030COOCOOCOO<X30000COOCOOOOOC»OCOOODOCOOOOOODOOOO« 


J-i-ja-i-Jtr-J-'-^'-^'-J-'-J-r-J-'-J-'-J-'-J-'-^'-J-'-^i-J-r-J-i-^i-^r-J-T-ja-'-J-r-J-i-J-^Zt--^ 


fO(^Jo^or^oo^Lf^li^^oo^-~(^J^LnoJ[^'-OLnooJ■vor-^-.c^c>J■rMC\Jvoc^^^cooc^ 

rooor^J-COr^i—  00O^!^C\JC0^-CMro<r)(X)0^zrO0^roLf^roC^V0^0C^'— f~o\0-d-'^ 

c\JL^^roJ-cr<^ooli^OM^c\Jl^J■'^r~ooo^cO'-c^J-o^^ooooO'-c\J(\JLn(^J^^^oc^^o 
c\J^C\Jcrc\J^c\J^rnJ■!v^J-roJ■<^J-roJ-J■JTcr-d■-d■Lr^J■LnLnLnLnlnLnlJ^l^ 

OOOOOOCOOOOOOOOOOOWOCOOOOOOOOOOOcaOOOOOOOCOOODOOOOOOOOOOOOOOOOODOOOOOOOCOOCOOOOOCOOOOOOOO 


r-Jd-T-J-'-J-'-Ji-J-T-^T-Jd-^J-'-J-l-J-'-^'-^'-J-'-^l-^l-J-'-J-r-ja-'-CfT-J-T-^t-J-r-J-T-J-T-:^ 


^vOCOrOiAOOOO>vOr-C\JJ-'-OOUAC-d-POOLnONC^roOC\JfOOOLni^I^'— ooojf^invoooooo 

li^OfOI-(»(^o^^o^roro(:^lnJ■«0'-LnLn'-^u^o{^J(^J^-^c\Jvol^o^J■coc^r^ 

^rOLr\J-r^r^J-CO^r-vOr*^r^a^OOOO(X)OC>CvJ(>LnOr^OON'—  >—  >— rOC\J^C\JOOrOOroC\JJ-LAL^ 

j-c\j^c\j-d-c\j^c\jJ-roj3-r<)j3-r^jroj--d-:d-j--d-^Lnj-Lnj-LnLnLnLnir\a^ 

OC0OC0OaDOa3O00O03O«3O00O0DOC0O00O00O00OC0O00Oa3O00O00O00O00O03O00O00O00O00O00O00OC0OC0O00 


J-»-ZrT-J-'-^'-^'-J-T-J3-r-J^i-J-,-J3-'-J-r-J-r-^r-J-T-Jd-'-J-'--3-r-J3-'-J-T-J-r-J-'--d-i-J-'-^'-J^ 


r^r-c\jLnoDi^r-j-oo^'— T-^r^vO"— T-ooroooooooc^fOi— o^^^JJ•t^'— ooLr\cor-c\j^ 

CvJvof^-d■■d■(^oDL^^c^^c\J^^^l^^ooc^oor-c^foc^Lnooooor-cMC^J-d■c\Jr-^^c^ 

c\Jzrc^JJ■c\JJ•c\JJ■c\JJ■foJ■roJ■rocrfOJ^J^J■J■J■J-Lr^J•li^LnlJ^lJ^LnLp\L^ 

00O00OC0O<»O00O03O00O00OC0O03O00OC0O00O00OC0O00OaDO00OC0O00OC0OC0O00Oa0O03O00O00O00O00O» 


T-^,-J-T-J-r-J-t-J-,-J-r-J^T-J-^^T-J-,-J3-i-Jr-J,-J-r-J-r-J-i-J3-r-J-r-J-r-J-r-J-r-^T-J-,-j3-T-:^ 


^oc^ro^OMD^~-^oa^00O^^^OT-u-^OC^J■OlA-d■C^^^00OC\J'-^oJ■r--\OVOC>O'-'-^^0JJ■« 

co^lAi— '-^-^(^ouc^f^(^-d■J■o^«5Ln'-c^^L^^vooo^^c^Jr-J^^^Lnc\JO^a^'-r^ 
\ooJLr^JJJ■^o-d■oD^oo(^r^Lr^I^^^cooooc^JO^^o^^oo^'— T-roc\jir\c\jcot^o^o^ 
crcMJ■c\J^c^JJ•c\Ja■^ocrfoJ■^ozrfOJ3■^zrJr•J■-d■L^^^L■^J■Lnlr^L'^L'^LnL^ 

OCOOOOOCOOCOOWOOOOOOOOOOOOOcaoaDOOOOWOCOOOOOCOOCOOOOOOOOOOOOOOOOOOOOCOOOOOOOOOOOCOOOOOOO 


J^T-J-t-JJi-^T-ja-T-J^-T-^^J-r-J-'-zrr-J-T-JTr-JT'-J-r-zrr-J-r-J-^Jd-^JJr-JTr-J-T-J^^J^ 


Oln^~-colnJ■J^J-c\Ja^lA<~ocOli^T-c^rocor^OJO^^oc\l^-ro^I^ooO'-T-LnJ■^u'^ooco 
o^c^J(^JcoJ■^c^r-J^J-c^'-'-lAcr'-t^^1-ro(^J^--p--cv-)r^cooLncMC^^LAo^oo^'-o^OI^^^ 

r-^Oo^J^^rof^LAC^vO'— r^J-l^vOCOOOCO'— O^^OO^U^O^^OO'— CMr-J-C\jvo<~oON<^'— 

OOOOTOOOOODOOOOOOOOOOCOOCOOOOOOOOOOOOOOOOOOOOCOOCOOOOOOOOCOOOOOOOOOOOOOOOOOOOOODOOOOOOOOOO 


r^^o^Ol^roLnc\JroovDr^o^CMC^JC^-:^^o^^CT^O-d■-d•OL^^lr^O'— c^vot>^c\JL^^^oo 
^o^\Jln^oJ•^J■cc^o\oc^J^~Lr^^^r^coo^o^c\JC^:3■o^ooc^'— 0'-(^c\Jlr^c\J^-ro(>^oo^ 
^c\JJ^c\JJ•c^JJ■rM■^•r^J•f^-d•ooJ■r^J•roJ3■-d■^-d■li^■S•L:^J■LAL'^lr^L'^Ln 

O00O00C00O00O00O00O0DO00OC0OaDOC0O00OC0OC0OC0O00OC0O00O00Oa3O00O00O00O«)OC0O00O00O00O00O« 


CfT-.d-T-J-r-J-i-^.-Jtr-J-r-J-i-Crr-J-l-J-T-J-r-JJr-J^T-JJi-^T-JjT-J-l-J-i-JT^J^r-^i-J-r-JJr-J^ 


Li_Li_Ij_Li_Ll.Li_Li_Ll.Li_LuLi_Ll.Lj_U_Lj_U.Li_Ij_Li_U.U_U.Li_U-Li.Lj_U^ 


F.40 


c^c^CM-d■'^<^'~oc-'^■c^J'— occu'^OJ^'^Cv.r^t^vC'— f^-'~^r~~rvC"\cc;c"cc~ 

^-CC'^C^>-'—  ^CM|■^<r)^^rO00rO(X5^aDzr00C■C^-'^C^J^C^Oa^OC^OO:■^O^~O■^O 

OCC3COOC>OC>OO^OC^CC^OC^CC^CC^OC^CC^CC>OC>OG^'—  (^i— C^'— ONi— C>'— 0^'— ON"— C^'— C^."— ON"—  On^ 


Oii^vCLnc>^^roc\;J■!^^cr^-^•L:^ooLr^c^|~oco^'— -:rcccooo\cooc-r'CNC\.'Ccc'0 

COl'^C^r^O^^^C\J^^C\(~--roeC^^CCl~OCC^OCJro^L'^C>u'^.  C^L'>.  c^^co^oc>oo^O'^ 

OOCCOOOOOC^OC^OO^CC^OO^OC^OC^OO^OC^CC^OC^OC^CC^'— C^'— CN"— C^"— C^'— ON"— (>'-Ont-CN'— CN-— 


o  r~-  \c 


■  o  r- 


vC 


.\0  ' 


or^or^vC'^vo'^vo^-o^^o^vo' —  oi^voi^ 


OOOCCC^L'^OCvCvO'-CDC•(VLr^'-rOOOO'— CV'-CMC\jr~~OrOu'^OC\jr^U^C>OC>vO^OO'-C>^ 
>— 0C~CVL'^O\O'~--^^C^C^^^'— r^f^C^JJ^L^^0^0^0^C\JCV^~f<:;OO~0D!^C•— CV"— 

OCOCOCOC^OC>OC^OC^OC^CC>OC^OC^OO^CC^CC^OO^OC>'— C>'—  C^i—  C>'-C>r-0\r-ONr-CN'— C^'-C>'— C>r^ 


^^o^^vo^^vo^~-vol^vo^~o^-vo^^Of^vc^^vo^~~vol^^O'^vo^^o^-vor^vc'^ 


00^^C^I^0^I^C\J[^C\;I^<^aDr^0D^O(0~^C^00J^C^u'^0^J^C>v0C^^0C^OO.■^O^^C'~~ 

C0O00O0DOC^OC^O0^OC^C0^OC^O0^OC^O0^O0^O0^O0^O0^'-0^^-<>^-c^'-C^'-0^'-0^'-0^'-0^'-C^'-C^'-C^'-C^'-C>'-C^^ 


vor^vor— \o? —  voh-vor^vo^--vor~-voi —  oi —  or^vor~-vo'^voi^vo!^voh~vof^vo>-vof~~-\0"^of^o?^0f^vor--ot^ot^ 


M^cococoLnLr^L'^^oOl^^c\JCVzrt^coc^JC<XDcoT-I—  L'>'— cocvvoi— OovooOin^^c^'— 
ocroc^Lr^'— j^oi— oo^^oc\jCvcc!^c^^^^vo^vCL'^cMO^.  c>crcvoL'^-occ>cDu'>ocoo 

r--ao^c>>-'— ^c^J^c\J^rooDfo<x)~oo^ccc■coJ^c^-'^c^L'^c^^oc^<;c^-^C"^C"^o^ 

OO^COCCC^CC^CO^OC^CC^OO^CO^OO^OC>OC>CO^OC^OC^O^>T-c>r-c^'— C^"— C^-— C>'— ^ 


^^\Oi^vo^-of^vo^-o^-or~~vor^vor^vol^^o^--vO!^vo^^vo^-^o^^vo^-Ol^ 


cor~-CNf^ONf^'— f^cv^^fooocoaDrooc~oc^coL'^o^u'^c>J^c^oc^\OC^oc^~c^-Ol^ 

C0CCCCCDOC^OC^O0^OC^OC^OC^CC^CC^OC^OC^OC^OC>CC^>'— CN"— C^'— C^'— ONi—  0^'— C^'— ^ 


^O^^vOI~~•vO!^0'^vOf~--0'^vC^^\0'~~0^~0!^0'^0^~OI^O^^vOf^vO'~^0'^0 


OCOOCCOC^OO^OO^OO^CC^OO^CC^OC^OC>CC^CC^OC^OC^Oa^'—  C^-—  C>'—  C^t— C^'—  C>'—  CN"— CN"—  ON-—  C^'-C^'— 


r^voi~--or^O'"~~vc'^o'^'0^^vor^of^vor-~vo'^vo'^o?^0'^0'^vo>-o'^o 


b-Li_li_Li.l^L_Ll_Ll-U.U-L-L.U-L^L-Li-Ll_U-L-U-tj-Lj_L-ij-U-Li-Ll-U^ 


C\J  J- lTM^  ON  00  J  VO  C\J  J"  li^ 

^  r- r-~  o  T- 1- o     ON  o  o        o  c\j 

>—  OCOOlTNJ'm'— LA  <—  lTNlTN 

1-  O      O  CM      CM  1-  C\J  00  CM  OMTN  ON 

I— Oi— O'— Ont— ONi— 00'—  o^-o 


vO^OO-^-"— J■00(^JvOJ■<^^^<-OJTLnvOlALAON^NOfOl^^CMOOJNOOOOONOOOOOO<>^<^NO^ 

NOirN^iXNjr^(\jLrNONu'^Li^ooooLnj-oovDf^c\jrooo-3-r^(\jroooo^j-'— c\j'— lAooii^ 

>—  C\JC\JO!^C0J•N0J•r-J■O^^LP\^0O-3•C\JJ•^0li^l^\^[^O00^-O'^C\J00<~0O^L'^roJ■<^ 

ONOON\ooNLnONLrNONLP\ooLrNvOLnr^r^i^r--r--i^i^r^i^f^r^r^r^oo(^oop~oor^cow 
or^or^or~--o^-or~-oi^or-or^o^-or-or--or~~or^ot^ot^o^~or-or^or-or-Oh-or- 


r--    1^       vo  o 


>o  r- 

r-  J3- 


J-T-Ji-J-'-J-'-J-'-^'-J-'-J-'-J-'-J-'-J-'-J-'-J-T-J-r-J-T-J-i-J-.-J-r-J-.-J-r-J-r-Zj-T- 


fo  >- CM  J- 00  m  o  r-- c\j  zr  00  r~- <- ltn 

J- O  1-  lA  00  O      T-  r-- r-  lTN  CMlAOvJ 

00  1—  O  ON  O  lA  lTN  lTN  00  lA  CM  O  r- lA 

O'-O'-OCMJ-CMOCMNO  lAOlA 

ont— O'— ONr-ONT— ctn"— 00  r^o^- 


j-j-r-r^oooo^iAr-r~-ro\OT-ON\ooNj-ONr~t^LA[^f^NOf^-d-cjN^r~j-r^r\jcor^CMi^LAvocMLAOrocM 

OOCM\OC3NVOI^vO<^jLAONro^J-oo>~r-roOONt^iA'—  r-^C^'^o^I—  1— \£)\0-C"<^ 
roCMr-CMC^r^^^JlA'—  ONr~~LA<-OC3NrO'— J-CM^J-LA^OvOI^vOONr^-—  COCOOOJC>LAroroj-r-L^ 

NOO^NOC>LAc>L'^c>LAc>J-|^lA^~-vot^l^^^l^r^I^r^^^^^r~-l^r^^~aol^oo^^cof^oococooooooo^^cor--OT 
r^o^-or--or^or^o^-oi~-or^or~-or^or~-ot^o^-or-or--or^o^-or^or~-or^or^or-o 


vO  P-  O 

r-  J-  r- 


^r^vor^NOr^Nor^'Oi^Noi^^t^^i^^r^^r^oi^MOi^'or^NOr--Mor~-NOh-vor^\o 

^J-T-J-r-J-r-^T-Jd-'-J-'-^'-J-T-Jd-'-^,-J3-r-J-,-J-r-J-r-crT-J-.-C)-r-z3-'-J3-T-^.-CrT-j3- 


for--r^j-oor^cv^CMP-fOi—  cmlaon 

vo  C\J  J- <-  00  <-o  CM  CM  O.  O  C7N  lAP-O 

r-  (ON  00  O  J- ^  LA  NO        LA  J-  r-  ,—  LA 

<- CON  <-  O  CM  CM  CM  CM  O  CM  On  lA  On 
>- C3n  T- o  r- ON     O     00 o  r- o 


NO^-CJNNO'— NOroJ■-d■LANOC7^'—  roCTNLALAJ-OOrONOf-NOi— ^OCCTnOOO"— \OONOrOJ-r-rooOOr^OOOr- 

vor^r^r~-jONC>c>ONp--'— r^c>NorocMooojLACMor^oo-d-LAr-ooNr--fr)CMr-0'-r^r^r--LAr^'-ON'-NO 

C\JC\iOrOOO<r)NOJ-i—  T—  C^CMLA^0Ocrr-J<v^|i^lALAN0vC00r^Or^r-00<^0NLArO^roCMJ■OlA0^ 

ONNOC^NOc3NlAONLAc>LAc>J■volAf^^--^^r^r-r^^-^-f^^-(^r^[^oo^^ooI^oop~-oooocooooooooooot~~^ 


r— Nor-r-~i^NOP-Nor-~NOh- 


h-  NO  r~ 
^ »-  J- 


i^Nor^Nor^vor^Nor^Nor^Nor^Nor^NOi^NOf^NOi^voi^NOf^Nor^vof^NOi^Nor^NOP^NOf^NOt^ 

^^J-r-JiJ-.-J-T-J-T-J-T-J-^ja-'-J-'-J-r-J-T-J-^J-.-J-.-ja-T-ja-i-J-.-^r-J-T-J-'-Cj-r-J-r- 


On  ^- ro  O  ^      ro  CM  CO  O  O  NO  NO  LA 

00      CM  J- CM  CM  NO  O  ro  O  ONOJ3- 

T-  O  CjN  O  LA  On  LA  r-  lA  CM  O  <-  LA 

Ot-O-—  OCMlACM'-CMNO  lAOnlA 

(ON  1— o    o  r- ON »- ON  1— 00  o 


lALAJri~-Or--ONOr~r^lAr^J-J-J-NOO(>OOaOr^<ONNO(ONlArOJ3-C7NroroCMr~-rOJ-COP-OOlACOr^O^ 
OCOnOCJNCONlA'— rO00LA00J-C>NOLAr--O'— ^(>'— f^r^'--=fOO'-^OCONO-3-NOCMCMLAf\jr--'— cOr^ONOCOrO 
^--CMCNJtONroaO^LAT-C^r^t^r^t^cv^r-J-CMJ-J-LALANOr^NOCTNP-OaOCMOOJ-C^LAroroj-r-^OLAI^NO 

NOCONNOONLAC7NLAC7NLAc:N:d-r^^NOLAr--r^r^r^r~r^r-r^r^r^r--r^r^aor^oo(^aor~-oooooocooococooo^-oo 
r--or-op~-or^or~-oh-oh-or~-or-or^or-or~oi^or^or^or^or^or~or~-o^-or-or~o 


Nor^^-r^r~-p~Nor~-Nor-~NO 


NO  r-  NO 

J3-  r- 


NOf^Nor~NOf^Noi^Nor^Nor^Noi^NOP~NO(^Nor^Nor^Nor^Noi^NOP~NOi^Nor~-Nor~--NOf^NO^-NDr~NOP~Nor~~ 

r-J-T-J-'-J-'-J-'-J3-i-Jr-crr-J-r-^T-cri-^'-^'-J'-J-'-^'--d-'-J-'--d-'-^'-^'-J-'-J- 


O  LA  CM  CM  NO  r-~  OO  J- 00  NO  (ON  00  J- NO 

lAOro(0NT-T—  O-d"'—  <~00  <—  u'^OO 

(On  CO  On  ^  O  lA  NO  lA  LA  LA  LA  i— t— 

(ON  r- ON  CM  C3N  CM  CNJ  CM  O  OvJ  (ON  lA  O 

<- (On  T-  (ON  T- (>,      ON  1- CO  1—  O  O 


CMO(ONl^CMr--(ONNOLAJ-NOOr--L'^CMfOCCMOOCMCMONOOCMCONOOO'-f^'-Lr\»-LAJ-J-'-rO(ONror--'-(ONi- 
lACnJJ^OC^t-t-Oni— N0ON0ONO^^NOO(0^N0-3■!^T-00^--NO<r)CV!'—  OOOiAroOCOOOf^ONr^(>CM'—  OOCNJ 
1—  t^CMOrOCONtv^f^J-LAi— Or^L'^t^O<^'— -d'POLAJ-LANONOOOr^C^r^'— 00f^c0cr(0Nj^fOCM^'—  l'^C^lA 

(ONNOC^NOcoNLA(>LA(ONLA(ONLANOLAl^^~^^^-l^l^r^l^^^l^^^(^f~~-^^l^co^--ool^oor^ 


r^Nor^NON-Nor^NOf^NO^- 


NO  p^ 
cr  js- 


r^NOP~-Nor^NOP-Nor^NDr^NOP^Nor^Nor^Nor^Nor--NOP-NOP~-NO^~NOP--NOP-NOP~-NOP~NO^-NOP^NOP~Nor^NO 

Jd-'-J-'-J-'-J-'-J-r-J-r-JTi-J-l-J-T-ja-r-JS-r-J-^jT-J-'-J-T-J-r-i-t-J-r-J-i-J-^J-l-^r- 


OOP-C\JO^(ONJ-00(>— ^o^0-3•N0N000^^LA^00^OL'^CMCMON0(>CMCM(>^CM'—  aOONNOC>NO(ONj-roj^(vi(^ 
NOr^ONONCMOOOT-u'^i-CO(ONC>NOJ-'-CM(ONrONOrOLArOCM(^CO^roaOcrrOJj[^'—  CMNO(ONrOL'^OCMO^ 

^^'-C^C0OLA(>LAT-L'^O-^{0Nr-LAL'^J•^— CM(MO<^OOJ■NOr-OJ■C^^^^~-rOOJ■CMJrOLAL'^NOP^NOOOr^OcOCMOO^o^ 

cON'-(ON'-ocMLACM'-CMaocM-d•<>LAC3NND(ONNO^ONNOc>lAcy^LAC3NLAcoJNOLAt^I^l^t^^-r^^~-^^^^r--I^r^r^aoP^oo^-oo^^« 
ONT-ONi-0'-coNr-c!Nr-oO'-p^oP--Oh-OP^or^or--OP~oh-OP~-or~-or--OP--OP^or~-OP^OP--0'^OP~or^oP~-o^-or^o^-OP--o 

NO^^NOP^p--^--NOP~-NOP-Nor--NOP--NOP--NO^~NOP--NO^~NOP^NOP--NOP~NOP--NO^--NOP--NO^^NOl^NOP~NOP-~NO^^OP^NOP-^ 

0^r-CMT-(>0(ONLAT-zf-d■OC>P-J-0'^LAOCMOOOCOLANONONOr-J^LA'-r-^fv^(>oooO'-OOCMCOI^NO'-NO^-J'-J■C^ 
LANO(>ONOroCMCOOlAC3NCOO-3■L'^(ONO^CMJ■'—  for^^NOJ■NOP~OOLALANOC^J■f^CO'-u'^NO<^rOOC^NO^OrOI—  C^ 
00'—  (0N^OLAjLA00jr^OOT-(0NOfOCMr-roC>ror^J-LA'—  C>r^u'^ro(0NrO'— zJCML'^J-LAONOOONOCTi^r-<X)^ 

i-c^i— (ONCMC^CMJ■CMOCMJ■OLAcONJ^ONOC>NOC>LA(ONLAC>.LA(ON^NOL'^^-NOP~-^^^^r^r^^-r^^~-^^^^r^p--^^cc^^co^-oop^ooo^ 
'-(>'-(ONi-(ONr-ONi-coNr-coo[^or-~OP~-or^O[^or^or--or^OP^or^or-~or^OP~-or--or~~or^or--OP~-or^or--or--or^or^ 

^~NOP~NOP^NO^^NOP--NOI^NO'— NOP^NOCMNOP--NO^--Nor^NO^~-NO^~NOP--NO^^NOP~NOP~-NOP--NO^^NOP~NO^-NOl^NO^~NO^~- 

J3-  1-  j3-  r-  j3-  r-  J-  <-  JT  r-  J3-  T-        t-  CT  r-  J"  ^  J"       J"  t-  J"  r-  ^  t-  J"  t-  J  <-  ^  <-  J"  «-  J"       J"       ^       ^       -T       -3-  >-  ^  r-  J"       CT  >-  J"       J"  r-  J"  i- 


Ll_Ll_LL.Lj_U.LJ_Lj_Ll_lj_lj_Lj_Li.Lj_Ll_Lj_ 


Li.Ij_Ul.U_U_Lx.1^Li.U.Li.Li.Lj_Li_Lj_ 


Li_Li-Li-Li.l^Li.b-U-U- 


F.42 


r~~roc\jc\jLnr-c\j'— I— oofor-- 

OC\jr>-ror-rorOLnC\JC\JONOJ 
h-J-r-CMOOOONCOO'OOJ- 

or--or-Oh-or^or~-Oh- 


ro    J- 1—  o  m  J- 
J-  ^  vo  CO  ^  o 

On  O  O  O  1—  00  ro 

r-  o  00  00  00  00  00 
o  r~  o  1^  o  o 


CTn  On  ro  ^  C\J  fO 
O  r~-  O  NO  ^  On 
lA  00      1—  m  CM 

»-     CM  r~-  CM 

O  C3N  O  On  O  O 


r-Nor~-Mor>-vor~-Nor~-NOh-NO 

j3-.-J-T-J-.-^i-J-T-J-i- 


NO  r--  ^  NO 

T-         T-  J-  T-  ^ 


r-  NO  NO  r~-  NO 
J-        T-  J- 1- 


CMO'-OOOOh-^-LAO-d-CM 

NOrONOf^rOO^NO^~NOLP\NOL^^ 

mr^fooor-ooONCJNr-Oir\'— 
r>-aor-oor^oONOooNOONOON 
r^or-or-~or-or--or-o 


J-  ro  lTN  CM  00  NO  J- 
C3N  CM  CM  >—  -d"  CM 
NO  CJN  O  >-  ON  CM  OO 

00  CJN  00  00  CO  00 
^-  o  r-  o  r-  o 


lA  lTN  C\J  NO  CJN  (3N 
r-  OO  O  CM  CM 
NO  CM      J-  CNJ  NO 

<-     CM  r--  CM 

C7N  O  ON  O  C3N  O 


Nor~-Nor^Nor^Nor~-NO^-Nor~ 

r—  J"'—  J""—  J"T—  Jt—  J^-r-J- 


NO  r~-  NO  r~  NO  NO 
T-  J- 1-  J- 1-  Jd- 1- 


No  ^-  NO    NO  r- 

T-  J-  T-  J?  r-  J- 


r-r^CMJ-NOJ-CMCMNO'-fOOO 

ONP^-r-LA^r-i^r-or-o^ 
NOJ■r--CMoooc^aooNOOJ■ 
oor~~oor~-oo^-aoNOCJNNOC3NNO 
op-or-or-or~-or-or- 


^  o  ^-  c^ 
o  m  NO  NO  NO  00 

o  T-  o  c^  <-  oo  CM 
ON  CO  CO  00  oo  00 

o  r~-  o     o  o 


o  lP\  la  in  00  lA 

r-  I-  J-  C>  CJN  J- 
NO  NO  CM      J-  CM  NO 

r--        CM     CM  r- 

O  OnO  ONO  OnO 


r^Nor~-Nor~-Nor^Nor~-NO(^NO 


^-  NO     NO  NO 

J-       J-       J-  r-  J3- 


h~  NO  NO  r--  NO 
J-  <-  J- 


roNOCMi-ONOOO'-r-OLAro 
OOrOOOOr~C7NOONOOOlAaOCM 

inr^fooO'-oocTNONr-OLA'- 
h~oor— oor^ooNOooNOC^NOc^ 
r--or-or-or^or--or--o 


r-J-LfMAOCMJ-fOlAOOCOONr-NO 

^-NocMC^J■^ocMT-oooL'^NO^NJONL^\ 
lAc^ooc^^NJoof*^NO-d■OfocMLANO 
oot~~c3NoooooooooO'— r^CMr^CNor-~<- 
^^or~•o^-Of^oooc3^oo^oc^ 


Nor~Nor^Nor^Nor^Nor~Noi^ 


Nor-Nor— Nor^NOf^Nor^Nor^-Nor^NO 

.-J-T-ja-t-J-i-JS-.-J-'-J-'-J-r- 


T-coc7NNONOL^c^^NOCMC3NO 

CJnOlACTnJ-CJN^  OnOOnI^C 
NOJ-r^CMOOOONOOONOOu'^ 

ooh-oor— oor-~coNOONNOONNO 
or^or--or-or--or^oi^ 


rOOlAJ-'-h-LAOOLfMrNLrNL'^J-OOO 

t-O'^OLANor-LAj-'-r-j-LALAj- 

ro^-OOr-OOCMlANONOCNj'-J-CMNO 
COONOOCTNCOOOODOOh-'-^-CMr-CMr^ 

o^^o^-or^o^--ooNOC^oc^o 


r^Nor~~Nor— Nor~~Nor-NOf~-NO 


r~-Nor^NO^-Nor~-Nor~Nor-Nor^Nor-~ 


iAOCM'-'-lAO'-OO'-^-CM 
OOsOO'-h-'-NOOCMOCM 
NONOJ-OOCMOOOONOOONO'- 

p-cor~-ooh-oor^ooNOcy\NooN 
f^or~-or-or-or>-or-o 


OOCTNl^Or-LAlACONOJ-'—  CMnOnOt- 
lAiA^OOJ-OncT'— lAC7NOrONOr~-r- 
lACJNOOO'—  OOf^NOJ-OfO'—  lACM 

oor— ooooocooDoO'-r~-r-r~-CMr-CM 

I^Oh-Oh-Or-OOOOOCAOON 


NOi^Nor^Nor^Nor^Nor^Nor— 
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User's  guide  provides  detailed  information  about  the  RID*POLY  (WRIS)  geo- 
graphic information  system.  Explains  how  to  prepare  maps,  digitize  and  scan  in- 
put, and  code  control  cards  to  operate  the  RID*  POLY  programs.  Component  pro- 
grams in  the  system  overlay  map  layers  (MOSAIC),  combine  map  layers  (MERGE), 
edit  map-files  (TONIC),  plot  map-files  (CHART),  produce  data  in  the  Universal  Data 
Exchange  Format  (XCHG),  and  convert  data  to  grid  format  (PGRID). 
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The  Intermountain  Station,  headquartered  in  Ogden, 
Utah,  is  one  of  eight  regional  experiment  stations  charged 
with  providing  scientific  knowledge  to  help  resource 
managers  meet  human  needs  and  protect  forest  and  range 
ecosystems. 

The  Intermountain  Station  includes  the  States  of 
Montana,  Idaho,  Utah,  Nevada,  and  western  Wyoming. 
About  231  million  acres,  or  85  percent,  of  the  land  area  in  the 
Station  territory  are  classified  as  forest  and  rangeland.  These 
lands  include  grasslands,  deserts,  shrublands,  alpine  areas, 
and  well-stocked  forests.  They  supply  fiber  for  forest  in- 
dustries; minerals  for  energy  and  industrial  development;  and 
water  for  domestic  and  industrial  consumption.  They  also 
provide  recreation  opportunities  for  millions  of  visitors  each 
year. 

Field  programs  and  research  work  units  of  the  Station 
are  maintained  in: 

Boise,  Idaho 

Bozeman,  Montana  (in  cooperation  with  Montana 
State  University) 

Logan,  Utah  (in  cooperation  with  Utah  State 
University) 

Missoula,   Montana   (in   cooperation   with  the 
University  of  Montana) 

Moscow,  Idaho  (in  cooperation  with  the  Univer- 
sity of  Idaho) 

Provo,  Utah  (in  cooperation  with  Brigham  Young 
University) 

Reno,  Nevada  (in  cooperation  with  the  University 
of  Nevada) 


